Pi Draft
Earendil · reviewed 22 November 2026 · its card
Pi lets a developer shape a coding agent to their own way of working: "Pi is a minimal, extensible agent harness that you can make your own", to be customised "with extensions, skills, prompt templates, and themes" and shared as Pi packages (S2). Earendil makes it: pi.dev credits "Earendil Inc. & Contributors", earendil.com says "Earendil crafts tools to harness AI with Pi and Lefos", and the repository sits in the earendil-works GitHub organisation (S1, S3, S2). It runs as the pi command on macOS, Linux and Windows, interactively in a terminal interface, in print or JSON mode for scripts, over RPC and through a TypeScript SDK (S2, S15). It is MIT open source, the licence held by Mario Zechner; models come from a provider subscription or API key the user connects (S1, S21, S2). The latest release seen is v1.6.0, of 20 November 2026 (S4). It is an agent harness and a client. Its skills follow the Agent Skills specification.
- An instance of
- Agent harness, Client
Capabilities
| Capability | Value | Detail | Sources |
|---|---|---|---|
| Model | Yes | Several providers, among them Anthropic, OpenAI, Google Gemini, DeepSeek, Mistral, GitHub Copilot and OpenRouter, by /login or API key; local GGUF models through the llama.cpp router |
S10 S11 S4 |
| Session | Yes | "Pi saves sessions automatically"; --continue, --resume and /resume reopen them, stored as trees in JSONL files with /tree, /fork and /clone |
S9 S15 |
| Subagent | Partial | Pi "skips features like sub-agents and plan mode"; its subagent example extension runs each subagent "in a separate pi process", or a package adds them |
S2 S17 |
| Agent team | Unknown | pi.dev says "Spawn Pi instances via tmux"; nothing read describes sessions working as a team | S1 |
| Skill | Yes | SKILL.md folders in user and project skills folders and .agents/skills, loaded on demand; "Pi implements the Agent Skills specification" |
S6 |
| Instruction file | Yes | AGENTS.md, AGENTS.override.md or CLAUDE.md from the agent folder, the working folder and its parents; SYSTEM.md and APPEND_SYSTEM.md replace or extend the system prompt |
S7 S1 |
| Plugin | Yes | Pi packages "install and distribute extensions, skills, prompt templates, and themes as one unit", from npm, Git or a local path | S12 |
| MCP | Yes | "Pi connects to Model Context Protocol servers over stdio or streamable HTTP", with OAuth; "MCP is built in" | S8 S1 S5 |
| Execution environment | Partial | none by default: "Pi does not include a built-in permission system"; its docs give Docker, Docker Sandboxes, OpenShell and the Gondolin micro-VM extension for container isolation |
S2 S14 |
| Client | Yes | Terminal interface, print and JSON modes, RPC "for IDEs, and custom user interfaces", and the SDK; sessions exported to HTML or shared as a gist; no desktop, web or mobile app found | S1 S15 S16 |
| Agent host | Unknown | Not found; Pi is the harness others host, as pi-ahp does | S19 |
| Channel | Partial | Only through extensions: "External integrations (file watchers, webhooks, CI triggers)" and pi.sendUserMessage(); Earendil's separate pi-chat extension "bridges Discord and Telegram channels to a sandboxed pi session" |
S13 S18 |
| Cross-session messaging | Unknown | Not found | None |
| ACP | Unknown | Not found | None |
| AHP | Partial | Only through pi-ahp, a separate third-party host by Qusic: "an Agent Host Protocol host for the pi coding agent", AHP 1.0.0 and 0.9.0, "under active development" | S19 S20 |
| A2A | Unknown | Not found | None |
| Bot | Partial | Only through the separate pi-chat extension: each connected Discord or Telegram channel gets a persistent workspace and "Durable memory"; pi-ahp says "pi has no scheduler or automation-run model" | S18 S19 |
State of play
How things stand, newest first, as the card records it.
- Version 1.6.0: GPT-6.2 Astra and GPT-6.2 Sol models, a breaking change to extension components, and fixes to MCP tools dropped on resume. S4
- pi-ahp, the third-party AHP host for Pi, reaches v0.6.3. S20
- Version 1.0.0: the terminal interface runs fullscreen by default, codemode is leaner and MCP OAuth is hardened; pi.dev says "We've shipped Pi 1.0 with Pi Durable". S5 S1