pi_agent_rust
High-performance AI coding agent CLI written in Rust with zero unsafe code
pi_agent_rust is a high-performance AI coding agent CLI written in Rust with zero unsafe code, serving as a native Rust port of the TypeScript Pi Agent. It provides a terminal-based coding assistant with streaming LLM responses, 36 built-in tools (including file operations, shell execution, web search, and LSP/debugging bridges), session management with branching, and an embedded QuickJS extension runtime. The agent runs on the asupersync structured concurrency runtime and uses rich_rust for terminal rendering, delivering a single-binary deployment with no Node.js dependency.
Key Features
Use Cases
- 01Terminal-based coding assistance with real-time streaming responses and tool execution for file editing, search, and shell commands
- 02Long-running development sessions with automatic compaction, session branching, and checkpoint/rewind for exploratory coding
- 03Multi-agent workflows using native subagents for parallel investigation or sequential task delegation
- 04Self-hosted or proxied LLM deployments via custom models.json configuration for Ollama, llama.cpp, vLLM, or other OpenAI-compatible servers
- 05Extension-based workflow customization with capability-gated QuickJS runtime for tools, slash commands, and event hooks
- 06IDE/editor integration via JSON-RPC protocol in RPC or ACP mode for programmatic control and streaming events
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
pi_agent_rust — FAQ
What is pi_agent_rust?+
pi_agent_rust is a native Rust AI coding agent CLI—a complete autonomous coding assistant with built-in tools, session management, and multi-provider LLM support. It is a Rust port of the TypeScript Pi Agent, designed for terminal use with a single-binary deployment.
How do I install pi_agent_rust?+
Download and run the installer script: curl -fsSL 'https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/install.sh?$(date +%s)' | bash. The installer fetches the latest release binary, verifies checksums, sets up shell completions, and optionally migrates existing TypeScript Pi installations.
Which AI clients or environments does it work with?+
pi_agent_rust is a standalone CLI agent, not a plugin. It runs directly in the terminal (interactive TUI or print modes) or can be controlled programmatically via RPC/ACP JSON protocol for IDE integrations (e.g., Zed editor via --acp).
What API keys or prerequisites are needed?+
You need an API key for your chosen LLM provider (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY). Local models via Ollama, llama.cpp, or mistral.rs require no API key. The binary runs on Linux (x86_64, aarch64), macOS (x86_64, arm64), and Windows.
Is pi_agent_rust free and open source?+
Yes, it is MIT-licensed open source. LLM API usage incurs costs from your provider (Anthropic, OpenAI, etc.), but local models (Ollama, llama.cpp) are free to run.
How does it handle extensions and security?+
Extensions run in an embedded QuickJS runtime with capability-gated hostcalls (tool/exec/http/session/ui). The default policy is permissive for compatibility; use --extension-policy safe/balanced or set extensionPolicy.defaultPermissive: false for stricter control. Command-level exec mediation blocks dangerous shell patterns by default.
How do I install pi_agent_rust?+
Open the source repository on GitHub and follow its README. pi_agent_rust is a agent — MCP Agents Market links you directly to the official repo.
Is pi_agent_rust free?+
pi_agent_rust is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.