pi-rust

Frequently asked questions

Short answers about pi-rust: what it is, how it differs from pi, how to install and update it, and which models, editors, and platforms it supports.

What is pi-rust?

pi-rust is a drop-in Rust port of the pi coding agent by Ryan Yannelli, built for 1:1 parity with pi. One binary has a streaming API for models from many providers, an agent loop that calls tools, and the pi command line.

Is pi-rust a drop-in replacement for pi?

Yes. It's the same pi command, and it reads ~/.pi/agent: your logins, settings, models, key bindings, MCP servers, sessions, extensions, and skills. Session files and RPC events match pi byte for byte, so you can switch between the two. Set PI_CODING_AGENT_DIR to use another folder.

Does pi-rust have full parity with pi?

pi-rust is a 1:1 port, and a workflow compares it with upstream pi every day. The latest report shows pi-rust has all of pi's CLI flags, slash commands, built-in tools, and extension API calls. Session files, settings, config paths, and RPC and JSON events match pi byte for byte.

Do pi extensions work in pi-rust?

Yes. TypeScript extensions, skills, prompt templates, themes, and pi packages work as they are. Extensions run on a built-in QuickJS engine with the Node built-in modules. Extensions that need native npm addons run on Node 22 or later when extensionRuntime is "node". pi-rust also runs native extensions written in Rust.

How is pi-rust different from pi?

pi-rust has everything in pi, runs without Node.js, and adds /diff, /review, /undo, /retry, pi doctor, run limits, structured output, ACP mode, subscription usage limits, and native extensions.

Does pi-rust need Node.js?

No. pi-rust is one binary, and extensions run on its built-in QuickJS engine. To run them on Node 22 or later instead, set extensionRuntime to "node".

How do I install pi-rust?

On macOS and Linux, run curl -fsSL https://pi-rust.com/install.sh | sh. On Windows, run irm https://pi-rust.com/install.ps1 | iex. With Homebrew, run brew install yannelli/tap/pi.

Which operating systems does pi-rust support?

macOS on Apple silicon and Intel, Linux on x86-64, arm64, and armv7, and Windows on x86-64 and arm64.

Which models and providers does pi-rust support?

Every provider pi supports, including Anthropic, OpenAI, Google, Amazon Bedrock, Mistral, xAI, GitHub Copilot, and OpenRouter, plus Cursor and Google Antigravity subscriptions. Log in with /login or an API key.

Does pi-rust work in Zed or other editors?

Yes. pi --mode acp runs pi as an agent inside Zed and other ACP editors, with no adapter.

Does pi-rust support MCP servers?

Yes, over stdio and HTTP with OAuth. Add servers to ~/.pi/agent/mcp.json or a project's .pi/mcp.json.

How much memory does pi-rust use?

About 36 MiB per session. With 20 sessions at once on a 16 GB Mac, pi-rust peaked at 680 MiB in total, against 3,431 MiB for Node pi and 3,275 MiB for Codex CLI.

How do I update pi-rust?

Run pi update --self. If you installed with Homebrew, run brew upgrade yannelli/tap/pi.

Is pi-rust free and open source?

Yes. pi-rust is MIT licensed, and the source is on GitHub at yannelli/pi-rust.

Who makes pi-rust?

Ryan Yannelli, a software engineer in New York.

Is pi-rust.com the website of upstream pi?

No. pi-rust.com is the website of pi-rust. Upstream pi is the TypeScript original by Mario Zechner, at github.com/earendil-works/pi.

Try