Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

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.

Terminal coding agents Terminal agentOpen source · MITFree to start

Use it in: CLI API / SDK Works with: MCP Local models Own API key Headless / CI

Price
Free (OSS)
free and open source
Popularity
#4 in Terminal
Gid Score 73 / 100 · #7 of 251 ranked AI agents
Trend
Growing fast
downloads up 36.3% over 30 days · up 1.6% last week
Development
Actively updated
latest 1.5.2, 10d ago
Community
123K GitHub stars
6.4M package downloads a week

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

MakerEarendil Inc. (created by Mario Zechner)
TypeTerminal agent
First releasedNovember 2025
LicenseMIT
InterfacesCLI, SDK
PlatformsmacOS, Linux, Windows
Models15+ providers (Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama and more) via API keys or OAuth
Local modelsllama.cpp, Ollama, LM Studio and vLLM via a custom base URL (docs)
Bring your own API keyYes
Main languageTypeScript
Open issues and PRs260
Homebrew installs8,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.

Compare prices of all agents

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

Full monthly summary

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.

Action needed: Azure provider renamed from azure-openai-responses to azure; update auth.json, models.json, and settings.json.
  • 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

All Pi use cases · All use cases

AgentGid articles about Pi

All guides

Get started with Pi

npmnpm install -g @earendil-works/pi-coding-agent
Homebrewbrew 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

All 5 reports, questions and fixes →

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 supports Agent Skills. Add ready-made skills for code review, slides, design, marketing and more: browse the Agent Skills catalog, with install commands for Pi.

Compare Pi with another agent

vs
# 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 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 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

All tools

What 105 public GitHub projects that depend on Pi use with it, from their dependency files.

  1. TypeScript81.0%
  2. Pi AI59.0%
  3. Vitest34.3%
  4. tsx33.3%
  5. yaml21.9%
  6. Model Context Protocol SDK (JavaScript)19.0%
  7. Zod18.1%
  8. Biome18.1%
  9. Anthropic SDK16.2%
  10. Vite14.3%

Used far more often here than in AI-built projects overall: what sets Pi projects apart.

  1. CodeGraph9.5% · 595.6×
  2. @langfuse/tracing6.7% · 34.7×
  3. Langfuse OpenTelemetry6.7% · 32.1×
  4. TypeBox9.5% · 18.6×
  5. smol-toml5.7% · 14.9×
  6. proper-lockfile8.6% · 14.5×
  7. minimatch6.7% · 13.9×
  8. 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.

  1. Release GitHub Releases

    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…

  2. Release GitHub Releases

    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…

  3. Official Vercel

    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

1.5.2
  • 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
1.5.1
  • 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
1.5.0
  • 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…
1.4.0
  • 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
1.3.0
  • 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
1.2.0
  • 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

Token prices of Anthropic modelsnewest Anthropic model in each family, output price per 1M tokens
Anthropic OpusAnthropic SonnetAnthropic Haiku

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.

Downloads per daynpm, 7-day average 912K/day
GitHub starsrunning total 123K
Hacker News mentionsposts and comments, rolling 7-day total 5 this week
Wikipedia page viewsEnglish Wikipedia, 7-day average 0/day
Website rankTranco list; a lower rank means more traffic #47,854

Download the raw daily series: pi.csv

Gid Score breakdown

Adoption85
Community87
Attention34
Momentum68

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

NumberLatest readingLast checked
Package downloadsNov 17, 2026Nov 19, 06:22 UTC
GitHub starsNov 19, 2026Nov 19, 06:26 UTC
Homebrew installsNov 19, 2026Nov 19, 06:26 UTC
Website rank (Tranco)Nov 18, 2026Nov 19, 06:33 UTC
Wikipedia viewsNov 18, 2026Nov 19, 06:26 UTC
Hacker News mentionsNov 18, 2026Nov 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:

AgentGid: #4 in Terminal Gid Score: 73/100 downloads: 6.4M/week ▲36% 30d

[![AgentGid: #4 in Terminal](https://agentgid.com/badges/pi-rank.svg)](https://agentgid.com/agents/pi/)
[![Gid Score: 73/100](https://agentgid.com/badges/pi-score.svg)](https://agentgid.com/agents/pi/)
[![downloads: 6.4M/week ▲36% 30d](https://agentgid.com/badges/pi-downloads.svg)](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.