# Pi Minimal terminal coding agent that you adapt to how you work with extensions, skills and your own models. Canonical profile: https://ki-agentenkompass.de/en/agents/pi/ Editor: [Michael Meierhoff](https://ki-agentenkompass.de/en/about/) Sources reviewed: 2026-11-05 Basis: provider documentation. Examples are editorial suggestions, not hands-on product tests. ## Overview Pi is an open-source toolkit from Earendil with a command-line coding agent. The former repository badlogic/pi-mono redirects to earendil-works/pi. - Provider: Earendil - Product family: Pi - Profile type: Terminal coding agent - Environment: Terminal on macOS, Linux and Windows; Android via Termux - Connections: Model providers, MCP, extensions and packages via npm or Git - Setup: Install by script or npm, then connect a model provider with /login. - Pricing model: Open source under the MIT licence. Model access needs a subscription, an API key or a local model. ## Key features ### Extensions and packages TypeScript extensions add tools, commands, events and interface parts. Packages can be shared via npm or Git. Source: https://pi.dev/ ### Four modes Interactive terminal interface, print or JSON output, RPC over standard streams and an SDK for embedding. Source: https://pi.dev/ ### Tree-structured sessions Sessions are stored as a tree, so you can jump to earlier points and continue from there. Source: https://pi.dev/docs/latest/sessions ### Many model providers Pi connects through a subscription, an API key or a local model; /model switches the model. Source: https://pi.dev/docs/latest/quickstart ### Control your context AGENTS.md, automatic compaction, skills and prompt templates determine what the model sees. Source: https://pi.dev/ ### MCP and Codemode According to the website, MCP is built in, and Codemode lets agents compose tool calls in JavaScript. Source: https://pi.dev/ ## Example workflows ### Code change with your own rules - Your input: A repository with AGENTS.md and a limited change. - Possible result: The agent edits files and runs commands with your permissions. - What to check: Check the diff and test results, ideally working in a container. ### Embed the agent in your own tools - Your input: A script that calls Pi in print or RPC mode. - Possible result: Machine-readable output for the next step. - What to check: Cover permissions, model costs and failure cases in the script. ## Requirements and limits ### Model access required Requirement: You need access to a model through a supported provider: a subscription, an API key or a local model. Source: https://pi.dev/docs/latest/quickstart ### No built-in sandbox Limitation: Pi runs with the permissions of the account that started it. The security page explicitly notes the lack of a built-in sandbox and assigns isolation to containers or virtual machines. Source: https://pi.dev/docs/latest/security ### No approval per tool call Limitation: Pi does not ask before every tool call. Approvals can be added through extensions. Source: https://pi.dev/docs/latest/security ### Sub-agents and plan mode not built in Limitation: Pi leaves these out on purpose. You build them yourself or install a package. Source: https://pi.dev/ ### Team and admin features Not yet confirmed: The reviewed pages describe no central administration for teams. Source: https://pi.dev/docs/latest/security ## A good fit if … - you work in the terminal and want to adapt the agent with your own extensions - you want to choose freely between model providers, a subscription, an API key or a local model - you want to build the agent into your own workflows through print, RPC or SDK access ## Less suitable if … - you expect a built-in sandbox or approval before every tool call - you need sub-agents and plan mode without additional packages - you need central team and admin management Editorial assessment based on provider documentation. Not a product test. ## Usable AI models Open choice Pi supports about 40 providers with API keys and sign-in through subscriptions, such as the ZAI Coding Plan or Kimi For Coding. OpenRouter and other gateways give you further models. You add your own endpoints in models.json, which according to the docs covers most Ollama, LM Studio and vLLM setups. - Model families named: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Mistral, xAI (Grok), Z.ai (GLM), Moonshot (Kimi) · Other models can be connected freely - Model choice: You choose - Your own API key: Yes - Router or custom endpoint: Yes - Local models: Yes Documented · Sources accessed on: 2026-11-05 - [Pi: Providers](https://pi.dev/docs/latest/providers) - [Pi: Models](https://pi.dev/docs/latest/models) ## Europe & regional availability Website, security and settings pages reviewed. They name no country release or data regions. Reviewed scope: Local software; model providers separately Reviewed on: 2026-11-05 ### Europe: no provider statement Availability still unclear Pi runs locally on your machine. The reviewed pages say nothing about Europe. Check model providers and their data regions separately. Anonymous install reporting is on by default and can be turned off. Region covered: EU/EEA, United Kingdom and Switzerland Documented reason: The reviewed sources name no country release for this. Official source: https://pi.dev/ Official source: https://pi.dev/docs/latest/settings ## Accounts & permissions Based on provider documentation. Permissions depend on the account, integration and organization policies. Review the permissions actually requested before use. Configuration covered: Local coding agent with your own model access Sources reviewed: 2026-11-05 ### Account used Documented: After /login, Pi stores model provider access in auth.json, as an API key or OAuth token. Evidence: https://pi.dev/docs/latest/providers ### Admin approval Open in reviewed sources: The reviewed pages name no approval or restriction by an organisation’s administrators. Evidence: https://pi.dev/docs/latest/security ### Data access & team sharing Documented: Pi acts with the permissions of the account that started it and does not ask before every tool call. You achieve isolation through containers, virtual machines or sandboxes. Evidence: https://pi.dev/docs/latest/security ## Prices and included usage Pricing checked: 2026-11-05 Pi is available under the MIT licence; the reviewed pages name no price for the tool. Costs of model access depend on the chosen provider. ### Pi No software fee stated Coding agent with your own model access. Price source: https://github.com/earendil-works/pi Terms for the optional Radius service were not reviewed. Pricing details: https://pi.dev/docs/latest/quickstart ## Operation & oversight Based on public provider documentation. Assessments are editorial inferences from the stated properties. Actual time requirements and reliability have not been measured. Deployment covered: Local operation in the terminal Sources reviewed: 2026-11-05 ### Files and working state Documented: Sessions persist by default under ~/.pi/agent/sessions/, grouped by working directory. Evidence: https://pi.dev/docs/latest/sessions ### Sign-ins Documented with conditions: Access depends on the provider: an API key or OAuth through /login, stored in auth.json. How long access lasts is up to the provider; the reviewed pages name no time limits. Evidence: https://pi.dev/docs/latest/providers ### Starting further runs Documented: You start Pi interactively or from scripts in print, JSON or RPC mode. The reviewed pages describe no built-in schedules. Evidence: https://pi.dev/ ### Human intervention Documented: Pi does not ask before every tool call. If you want approvals, add them through extensions. Evidence: https://pi.dev/docs/latest/security ### Detecting errors Documented with conditions: For transient failures, Pi retries automatically, by default up to three times. The setting can be changed. The reviewed pages do not say how other failures become visible. Evidence: https://pi.dev/docs/latest/settings ### Resuming after failures Documented: You continue interrupted work in the saved session with --continue, --resume or /resume. Evidence: https://pi.dev/docs/latest/sessions ### Editorial assessment You are responsible for isolation and control yourself, as Pi works with your permissions and without asking per tool call. Plan for containers or your own approvals. ## Memory and conversation continuity Scope: Local session files of the coding agent Sources accessed: 2026-11-05 Sessions are stored locally and can be resumed; the pages document no memory across sessions. ### Storage and scope Documented: Sessions are stored by default under ~/.pi/agent/sessions/, grouped by working directory. The location can be changed. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) ### Selection and timing Partly documented: Sessions are saved automatically unless --no-session is used. No selection mechanism for lasting memories is described. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) ### Inspect, edit and delete Partly documented: The session picker can search, rename and delete. The file format is documented. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) ### Agent and channel boundaries Partly documented: Sessions are grouped by working directory. The reviewed pages describe no boundaries between agents or channels. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) ### Retrieval Partly documented: Resume with --continue, --resume and /resume. No content search across earlier sessions for automatic retrieval is described. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) ### Session reset and compaction Documented: /new starts afresh. Compaction is on by default and controlled through settings. - [Pi: Sessions](https://pi.dev/docs/latest/sessions) - [Pi: Settings](https://pi.dev/docs/latest/settings) ## Context A repository, model access and a limited coding task. Pi runs with your account’s permissions and does not ask before every tool call, so the documentation recommends containers or virtual machines for more isolation. Official website, documentation and repository reviewed. Feature descriptions come from the provider; example tasks are editorial. Hands-on tests are still pending. ## Open points Europe, availability still unclear: - Europe: no provider statement Requirements and limits, not yet confirmed: - Team and admin features ## Sources - https://pi.dev/ - https://pi.dev/docs/latest/quickstart - https://pi.dev/docs/latest/security - https://pi.dev/docs/latest/sessions - https://pi.dev/docs/latest/settings - https://pi.dev/docs/latest/providers - https://pi.dev/docs/latest/how-pi-works - https://github.com/earendil-works/pi ## Provider Earendil Inc. and contributors maintain Pi as an open-source project under the MIT licence. - Operator: Earendil Inc. - Organization: Provider - Website: https://pi.dev/ - Reviewed: 2026-11-05 - Repository: https://github.com/earendil-works/pi - GitHub-Stars: 120243 (2026-11-05) - License: MIT - Provider source: https://pi.dev/ - Provider source: https://github.com/earendil-works/pi [Sources and method](https://ki-agentenkompass.de/en/sources/)