Open agent

Pi

A minimal, extensible coding-agent harness you shape with extensions, skills, prompt templates and themes; it skips sub-agents and plan mode by design.

Checked Oct 25, 2026

Stars

117,653 api.github.com/repos/earendil-works/pi · checked Oct 25, 2026

License

MIT

Runs

LocalRuns with the permissions of the user that starts it; no built-in permission system (containerize or sandbox it for stronger limits).

Latest release

v1.4.0 · Oct 21, 2026

What it is

A minimal, extensible coding-agent harness you shape with extensions, skills, prompt templates and themes; it skips sub-agents and plan mode by design.

GitHub repo · pi.dev · @pidotdev

X account: verified account; profile links pi.dev. The repo moved from badlogic/pi-mono to earendil-works/pi (GitHub redirect).

Install

curl -fsSL https://pi.dev/install.sh | sh
powershell -c "irm https://pi.dev/install.ps1 | iex"
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
nix run github:earendil-works/pi/stable

raw.githubusercontent.com/earendil-works/pi/HEAD/README.md · checked Oct 25, 2026

Models

Unified multi-provider API (OpenAI, Anthropic, Google and others); run /login inside Pi to connect a subscription or an API key.

raw.githubusercontent.com/earendil-works/pi/HEAD/README.md · checked Oct 25, 2026

Recent updates

Dated changes from Pi's releases and changelog and its official X account (@pidotdev), newest first. Posts on X are marked until docs or a release say the same. Nothing is removed. Checked Oct 25, 2026.

October 2026 11 updates

Oct 21, 2026
Release
v1.4.0 Image input for classifier models (Jev, Clef); a Models Configuration reference; compaction summaries no longer fail on long reasoning; codemode waits for a free worker
github.com/earendil-works/pi/releases/tag/v1.4.0
Oct 21, 2026
On X · not in docs
Recursive Flint, RL-trained on the Pi harness, is free in Pi via Radius
x.com/pidotdev/status/2112978311252979761
Oct 15, 2026
Release
v1.3.0 Choose where /share uploads (gist or radius); changing the thinking level on GPT-6 keeps the prompt cache
github.com/earendil-works/pi/releases/tag/v1.3.0
Oct 13, 2026
On X · not in docs
Local models in Pi on NVIDIA RTX Spark laptops, with a llama.cpp setup guide
x.com/pidotdev/status/2110064527173620001
Oct 12, 2026
Release
v1.2.0 Per-key OpenRouter model lists; published config schemas for editor validation; clipboard copy over remote sessions (OSC 52)
github.com/earendil-works/pi/releases/tag/v1.2.0
Oct 7, 2026
Release
v1.1.0 Status reporting to terminals and dashboards (OSC 7501); Claude Haiku 5.5; adjust default tools with +name/-name
github.com/earendil-works/pi/releases/tag/v1.1.0
Oct 5, 2026
Release
v1.0.4 * patterns in --tools and --exclude-tools, plus --no-mcp; codemode keeps images from tools.read()
github.com/earendil-works/pi/releases/tag/v1.0.4
Oct 5, 2026
Release
v1.0.3 Azure Foundry Chat Completions deployments (azure/deepseek-v4-pro); codemode images saved to files
github.com/earendil-works/pi/releases/tag/v1.0.3

3 more updates in October 2026

Oct 4, 2026
Release
v1.0.2 Per-thinking-level sampling parameters in models.json
github.com/earendil-works/pi/releases/tag/v1.0.2
Oct 3, 2026
Release
v1.0.1 Nix flake; per-project MCP server overrides (.pi/mcp.json); MCP Client ID Metadata Documents
github.com/earendil-works/pi/releases/tag/v1.0.1
Oct 1, 2026
Release
v1.0.0 Pi 1.0 with Pi Durable: fullscreen TUI by default, about 40% fewer codemode prompt tokens, image generation in codemode
github.com/earendil-works/pi/releases/tag/v1.0.0 · x.com/pidotdev/status/2105738462712209603

September 20263 updates

Sep 30, 2026
Release
v0.99.2 MCP servers stay out of the codemode description by default; more MCP auth options; Anthropic workload identity federation
github.com/earendil-works/pi/releases/tag/v0.99.2
Sep 29, 2026
Release
v0.99.1 GPT-6.1 Sol available and the default OpenAI Codex model
github.com/earendil-works/pi/releases/tag/v0.99.1
Sep 29, 2026
Release
v0.99.0 MCP at the core with codemode (models run JavaScript that calls tools in parallel); system theme from your terminal palette; Sign in with ChatGPT
github.com/earendil-works/pi/releases/tag/v0.99.0 · x.com/pidotdev/status/2104992471155696120

Cost

Free and open source (MIT); you bring a subscription or API key.

raw.githubusercontent.com/earendil-works/pi/HEAD/README.md · checked Oct 25, 2026

Features

Extensions, skills, prompt templates and themes, shared as Pi packages via npm or git raw.githubusercontent.com/earendil-works/pi/HEAD/README.md
Interactive TUI, print/JSON mode, RPC control and a TypeScript SDK; OpenClaw is cited as a real-world integration raw.githubusercontent.com/earendil-works/pi/HEAD/README.md
Sandboxing patterns documented: Gondolin micro-VM extension, plain Docker, OpenShell raw.githubusercontent.com/earendil-works/pi/HEAD/README.md

Use cases

Added in R34 (2026-10-25); use cases not collected yet.

Complaints and issues

None found.

FAQ

Does Pi sandbox what the agent does?

No. Pi has no built-in permission system and runs with your user's permissions. The README documents three ways to isolate it: the Gondolin micro-VM extension, plain Docker, or OpenShell.

raw.githubusercontent.com/earendil-works/pi/HEAD/README.md · checked Oct 25, 2026