- Fork sessions whose folder is gone: when a session's original folder was moved or deleted, you can now fork it into the current folder instead of only continuing, so later resumes no longer ask.
- When a session's working directory no longer exists, for example after the project folder was renamed, interactive mode now offers Continue, Fork, or Cancel instead of only continuing.
- Fixed /import of a session whose working directory no longer exists leaving a copy in the session directory, and continuing it leaving a second copy with the same ID (s.jsonl and s-1.jsonl).
- Fixed Anthropic OAuth requests reporting an outdated Claude Code version
Pi by Earendil Inc. (created by Mario Zechner)
Minimal, extensible open-source coding agent harness with interactive TUI, print/JSON, RPC and SDK modes, created by Mario Zechner and now maintained by Earendil Inc. It supports 15+ model providers through API keys or OAuth and is customized with TypeScript extensions, skills and packages. Its tools and extensions run with the permissions of the Pi process; Pi does not sandbox tool calls or ask before each one.
Use it in: CLI API / SDK Works with: MCP Local models Own API key Headless / CI
On this page
Usage data: latest readings Nov 17 to Nov 19, 2026, last checked Nov 19, 06:33 UTC. Date of each number
What Pi does
Pi is a terminal agent from Earendil Inc., first released in November 2025. You use it through a command-line tool and an SDK on macOS, Linux and Windows. Its documentation covers MCP servers, a non-interactive mode for scripts and CI, your own API key and local models. It can run models from Anthropic, OpenAI, Google, xAI, Mistral and Moonshot (Kimi) and others. It is free and open source (MIT); you pay only for the models it calls.
Teams use it for: DevOps and CI, Internal tools, Workflow automation. See examples.
Recent developments
- 2026-05-07: project moved to Earendil Works (repo earendil-works/pi, npm scope @earendil-works); 2026-10-01: Pi 1.0 announced
Key facts
| Maker | Earendil Inc. (created by Mario Zechner) |
|---|---|
| Type | Terminal agent |
| First released | November 2025 |
| License | MIT |
| Interfaces | CLI, SDK |
| Platforms | macOS, Linux, Windows |
| Models | 15+ providers (Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama and more) via API keys or OAuth |
| Local models | llama.cpp, Ollama, LM Studio and vLLM via a custom base URL (docs) |
| Bring your own API key | Yes |
| Main language | TypeScript |
| Open issues and PRs | 260 |
| Homebrew installs | 8,441 in 30 days · 55,123 in a year |
Pricing
Free and MIT-licensed; costs are those of the chosen model provider. Pi Durable (experimental) is also free per the 1.0 announcement.
Checked Nov 5, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?Yes (MIT)
- Works with local models?Yes
- Bring your own API key?Yes
- Runs onmacOS, Linux, Windows
- Where you use itCLI, SDK
- Supports MCP?Yes
- Model providersanthropic, openai, google, xai, mistral, moonshot, amazon, openrouter, any OpenAI-compatible, local
- Runs in scripts / CI?Yes
- Feature comparisonAll agents
- Closest alternativeClaude Code · all alternatives
What's new in Pi: October 2026
October brought Pi to version 1.0 with a major redesign of the terminal interface and significant improvements to authentication, image handling, and tool integration. The month included refinements to codemode efficiency and expanded support for third-party services.
- Terminal now runs fullscreen by default with configurable behavior for regular scrollback mode.
- Codemode now generates images natively and uses 40% fewer prompt tokens with better error recovery.
- MCP server authentication hardened with OAuth improvements and project-level configuration overrides.
- Azure Foundry Chat Completions support added alongside the main Azure provider.
5 releases this month · summarised from the official release notes · all months
How teams use Pi
Run the pi harness in isolated sandboxes with the self-hosted pi pod
An independent developer, Evan, introduces pi pod, an ongoing open project built on top of the pi coding harness. It aims to run a user's existing pi setup in an isolated sandbox …
No measured results are reported; the article is a project introduction.
Route between coding-agent models with the open-source Weave Router 2.0
The Weave team presented Weave Router 2.0 in a Show HN post. It is an open-source routing model that sits in front of coding agents and switches between LLMs per turn, and the aut…
As reported by the Weave author on Hacker News: on Terminal Bench 4.0 and SWE Atlas, the router had equivalent pass rates to GPT-6 Astra.
AgentGid articles about Pi
How to Start Using a Terminal Coding Agent: Setup, First Tasks and Guardrails
A practical manual for your first week with a command-line coding agent: installing one, running a first session, writing project instructions, setting permissions and keeping costs under control.
What Is MCP (Model Context Protocol)? A Plain Guide and the Most Popular MCP Servers
What the Model Context Protocol is, how MCP servers and clients work, which AI agents support it, how to install a server safely, and the most-starred MCP servers by category.
Best AI Agents in 2026: Live Rankings by Category
The leading AI agents for coding, design, research, data, marketing, sales, support, HR, finance, legal, DevOps and security, ranked by public usage data that refreshes daily, with prices and free options.
Get started with Pi
| npm | npm install -g @earendil-works/pi-coding-agent |
|---|---|
| Homebrew | brew install pi-coding-agent |
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
What Pi users report right now
Open Users report that with Sign in with ChatGPT, Pi gives GPT-6.1 Sol and Terra a 272K context window although the account's own model list reports 500K, so sessions compact earlier than needed. Reports cover 1.3.0 to 1.5.0; a maintainer said OAuth and API-key logins currently share the same model definitions.
Reported on GitHub · 8 👍
Open Users on an Anthropic subscription with extra usage report that requests sometimes hang around :00 and :30 UTC: the server answers and sends keep-alive pings but never the reply, so Pi's automatic retry does not start. Reports continue on 1.3.0 and the issue is open.
Reported on GitHub · 6 👍
Open Request Teams that host pi-durable for their own users ask for a way to permanently delete a conversation: the store is append-only and has no delete API, so a deleted chat's message history stays in storage.
Reported on GitHub · 6 👍
Fixed Users reported that streamed replies were drawn one word or one character per line, mostly with reasoning models through OpenRouter, sometimes freezing the terminal. A maintainer pointed to fix commits and closed the issue; reporters said it stopped after updating to 0.84.4.
Reported on GitHub · 9 👍
Fixed Users reported that on Amazon Bedrock, OpenAI-family models counted cached tokens inside the input count, so Pi showed false cache-miss notices and about double the cost. Users traced it to an AWS-side defect that AWS fixed, and a project collaborator closed the issue as fixed upstream.
Reported on GitHub · 5 👍
The most discussed problems in its GitHub repository, checked Nov 12, 2026. Written by AgentGid in its own words; statuses and fix versions come from the project's own pages. Reports are users' accounts, not AgentGid tests.
Pi alternatives
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
Claude CodeAnthropic |
88 | 18.9M | up 15.1% | up 15.5% | 156K+136/day | 2.1.328yesterday | $20/mo | |||
| 2 |
OpenAI CodexOpenAI |
84 | 26.6M | up 2.4% | up 7.4% | 136K+144/day | 0.168.07d ago | Free + $8/mo | |||
| 3 |
OpenCodeAnomaly (SST team) |
80 | 3.9M | up 15.4% | up 28.7% | 228K+266/day | 2.3.22d ago | Free + $10/mo | |||
| 15 |
Gemini CLIGoogle |
62 | 495K | up 16.9% | up 6.8% | 109K+35/day | 0.69.0yesterday | API usage or license | |||
| 20 |
ClineCline Bot Inc. |
58 | 84.3K | down 8.7% | up 14.9% | 71.8K+38/day | 4.1.2625d ago | Free + $9.99/mo | |||
| 22 |
GitHub Copilot CLIGitHub (Microsoft) |
56 | 1.7M | down 8.3% | up 8.3% | 11.4K+6/day | 1.0.1142d ago | Free + $10/mo | |||
Head to head: Pi vs OpenCode · Pi vs OpenAI Codex · Pi vs Claude Code · Pi vs Gemini CLI · Pi vs mini-SWE-agent
Tools used with Pi
What 105 public GitHub projects that depend on Pi use with it, from their dependency files.
- TypeScript81.0%
- Pi AI59.0%
- Vitest34.3%
- tsx33.3%
- yaml21.9%
- Model Context Protocol SDK (JavaScript)19.0%
- Zod18.1%
- Biome18.1%
- Anthropic SDK16.2%
- Vite14.3%
Used far more often here than in AI-built projects overall: what sets Pi projects apart.
- CodeGraph9.5% · 595.6×
- @langfuse/tracing6.7% · 34.7×
- Langfuse OpenTelemetry6.7% · 32.1×
- TypeBox9.5% · 18.6×
- smol-toml5.7% · 14.9×
- proper-lockfile8.6% · 14.5×
- minimatch6.7% · 13.9×
- ignore4.8% · 11.0×
Ratings from people who use Pi
No ratings yet. Used Pi? Rate it and say what it is good and bad at.
Pi news
-
Pi 1.5.2 released
Fork sessions whose folder is gone: when a session's original folder was moved or deleted, you can now fork it into the current folder instead of only continuing, so later resumes no longer ask.; When a session's working directory no longer exists, for…
-
Pi 1.5.1 released
Shell login and logout: use pi auth login and pi auth logout without starting a session, with API-key and no-browser sign-in options. See Credential commands.; Idle prompt cache warming: eligible caches now stay warm for up to 30 minutes between runs when a…
-
GLM 5.3 Flash is now available in Token Pass
Token Pass subscription now includes GLM 5.3 Flash model with 1M-token context window for use with coding agents.
What changed: recent Pi releases
23 stable releases in the last 90 days · Monthly summary · Full changelog
- Shell login and logout: use pi auth login <provider> and pi auth logout <provider> without starting a session, with API-key and no-browser sign-in options. See Credential commands.
- Idle prompt cache warming: eligible caches now stay warm for up to 30 minutes between runs when a refresh is expected to pay for itself. See cacheWarming.
- Anthropic message threads: requests send only new messages while the server continues the conversation, with full-request fallback when earlier context changes. See Anthropic compatibility.
- Richer Mermaid diagrams: pie charts, author-defined styles, clickable labels on supported terminals, and diagrams in expanded branch and compaction summaries.
- GitHub Copilot classifiers: call Microsoft-Decision-1 through codemode models.classify() for typed decisions and probabilities. See Use classifier models.
- Package update summaries: pi update --extensions reports each package's npm version or git commit change and distinguishes unchanged, skipped, and warned updates. See Update Pi or packages.
Earlier releases
- Extension update changelogs: see what changed in installed extension packages on the next fresh launch after an update.
- Faster streaming: large tool calls are parsed incrementally, and code-heavy answers and tool rows reuse highlighting and rendered Markdown instead of repeating the work on every update.
- Custom self-update commands: use PI_SELF_UPDATE_COMMAND or selfUpdateCommand to update pi through a wrapper or another package manager. See Custom update command.
- GPT-6.1 Terra: available through OpenAI, Azure OpenAI Responses, and OpenAI Codex, with tool search, mid-conversation thinking-level changes, and thinking off. Codex offers a 500K context window.
- Tool argument validation runs on @earendil-works/pi-schema. TypeBox features outside JSON Schema (Type.Refine(), Type.BigInt(), Type.Undefined(), codecs, Format.Set() formats) no longer apply to…
- Extension packages can now show their changelog after an update. Pi reads pi.changelogPath from the package's package.json, or CHANGELOG.md in the package root, and on the next fresh launch shows…
- Image input for classifiers: codemode models.classify() accepts images for TypeSafe's Jev and Cloudflare's Clef models on typesafe, cloudflare-workers-ai, and OpenRouter.
- Models Configuration reference: every provider, model, model override, and compatibility field of models.json, generated from its schema. See Models Configuration.
- Summaries without a fixed output cap: compaction and branch summaries use the model's output limit, so long reasoning no longer makes them fail. See Compaction.
- Codemode waits for a free worker: parallel scripts and in-process subagents queue instead of failing, and PI_CODEMODE_MAX_WORKERS raises the limit. See Codemode limits.
- Rex terminal support: OSC 8 hyperlinks, truecolor, and inline images.
- Added a Models Configuration reference generated from the models.json schema, listing all provider, model, model override, and compatibility fields
- Choose where /share uploads: sessionShareDestination selects auto, gist, or radius. See Sessions and context and Export or share a session.
- Cache-preserving thinking level changes on OpenAI GPT-6: changing the thinking level mid-session with an API key keeps the prompt cache.
- Kimi Code over Chat Completions: tools added mid-conversation no longer invalidate the prompt cache. models.json base URL overrides must now include /v1. See Providers.
- Clean model switching: thinking from a previous model is dropped instead of being shown to the new model as text.
- Resumed sessions keep their active tools: --tools +name/-name applies on top of them. See Tools.
- Changing the thinking level mid-session on OpenAI GPT-6 models (API key) now keeps the prompt cache
- Per-key OpenRouter model lists: with an OpenRouter key, Pi lists only the models that key may use, with the key's context size, max output, and prices, including regional endpoints set in…
- Published configuration schemas: add $schema to settings.json, models.json, keybindings, and themes for editor validation and completion. See Settings, Models, Keybindings, and Themes.
- Clipboard copies over remote sessions: PI_CLIPBOARD_OSC52=1 sends copied text to a remote client's clipboard when Pi cannot detect the remote session, such as a multiplexer attached from another…
- Codemode improvements: tool declarations show input constraints such as integer, minimum/maximum, and default, and codemode rows show elapsed and total time. See Codemode.
- before_agent_start for extension-triggered runs: runs started by pi.sendMessage(..., { triggerTurn: true }) go through the same setup as prompts. See Events and concurrency.
- Published generated configuration schemas for models, settings, keybindings, and themes at The theme schema moved to themes loaded during startup now receive the same schema validation as later…
Pi prices over time
Pi popularity and usage data
Pi was downloaded 6.4M times from npm in the week ending Nov 17, 2026, up 1.6% on the week before and up 36.3% over the last 30 days compared with the 30 before. The GitHub repository has 123K stars, 6,733 of them added in the last 30 days. The latest stable release is 1.5.2, published Nov 10, 2026; there were 4 stable releases in the past 30 days. It was mentioned in 43 Hacker News posts and comments over the last 30 days.
Download the raw daily series: pi.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 17, 2026 | Nov 19, 06:22 UTC |
| GitHub stars | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Homebrew installs | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Website rank (Tranco) | Nov 18, 2026 | Nov 19, 06:33 UTC |
| Wikipedia views | Nov 18, 2026 | Nov 19, 06:26 UTC |
| Hacker News mentions | Nov 18, 2026 | Nov 19, 06:26 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
Pi FAQ
How much does Pi cost?
Free and MIT-licensed; costs are those of the chosen model provider. Pi Durable (experimental) is also free per the 1.0 announcement.
Is Pi open source?
Yes. Pi is open source, released under the MIT license.
How popular is Pi?
Pi was downloaded 6.4M times from npm in the week ending Nov 17, 2026, up 1.6% on the week before and up 36.3% over the last 30 days compared with the 30 before. The GitHub repository has 123K stars, 6,733 of them added in the last 30 days. The latest stable release is 1.5.2, published Nov 10, 2026; there were 4 stable releases in the past 30 days.
What is the latest version of Pi?
The latest stable release we track is 1.5.2, published on Nov 10, 2026.
What are the alternatives to Pi?
The closest alternatives in the same category by Gid Score are Claude Code, OpenAI Codex, OpenCode, Gemini CLI.
For the makers of Pi badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/pi/)
[](https://agentgid.com/agents/pi/)
[](https://agentgid.com/agents/pi/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
npm: @earendil-works/pi-coding-agent. GitHub: earendil-works/pi. Homebrew: pi-coding-agent. Wikipedia: Pi (AI agent). Site rank: pi.dev on the Tranco list. See data sources for how each one is collected.
Product facts and pricing were checked against: pi.dev, earendil.com, github.com, registry.npmjs.org, formulae.brew.sh, en.wikipedia.org.