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
Conforms to
Model Context Protocol (MCP), Agent Skills specification

How to read a product card.

Capabilities

A product page in four labelled parts: what it is and who makes it; the capabilities table, with columns term, value, detail and sources, and the values yes, partial, no and unknown shown by the matrix's glyphs; the state of play, dated, newest first; and the sources, each with the date it was read.
How to read a product page. Every product has the same parts in the same order.
CapabilityValueDetailSources
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

Sources