Prux is a minimal terminal coding agent

Prux, a minimal terminal coding agent written in Rust as a rewrite of @earendil-works/pi-coding-agent, has been released on crates.io and installs via `cargo install prux`. The agent ships built-in tools (read, bash, edit, write, grep, find, ls), supports Anthropic, OpenAI, and DeepSeek providers, and extends functionality through Rust extensions including MCP, subagents, and a QuickJS codemode sandbox. Prux has been tested with opencode-go and deepseek, and its documentation is written in Chinese under assets/docs/.

A minimal terminal coding agent opencode-go and deepseek have been tested. ⚠️ NOTE: So far only prux is a minimal terminal coding agent. The core stays small and focused, and its capabilities are extended through extensions, skills, prompt templates, themes, and customizable keybindings. It is a Rust rewrite of @earendil-works/pi-coding-agent https://github.com/earendil-works/pi , staying aligned with upstream in behavior and wording for the most part. - Interactive TUI : a full-screen terminal interface with themes and customizable keybindings. Requires stdin/stdout to be a TTY. - Built-in tools : read / bash / edit / write / grep / find / ls , covering common coding tasks. - Multiple providers : supports API providers such as Anthropic, OpenAI, and DeepSeek, with custom and virtual model routing. - Session management : session persistence, /resume restoration, forking, and tree navigation. - Context compaction : /compact compacts long contexts, with branch summaries. - Extension system : implement the Extension trait in Rust to provide tools, commands, keybindings, CLI flags, and event hooks. - Built-in extensions : MCP, subagents, codemode QuickJS sandbox orchestration , skills, scheduled tasks, plan mode, and more. Install the released binary from crates.io requires a Rust toolchain : cargo install prux Or build from source: cargo build --release ./target/release/prux --version Common commands: make cargo build --release make build compile only debug make debug cargo run make check cargo check cargo test full test suite cargo clippy static checks cd /path/to/project prux On the first run, configure a provider with /login inside the TUI, or set the environment variable before launching: export ANTHROPIC API KEY=sk-ant-... prux Settings are written to ~/.prux/ the agent directory, overridable with $PRUX AGENT DIR : credentials in auth.json , global settings in settings.json , and so on. Besides conversational mode, the following commands do not require a TTY: - prux auth : credential management - prux mcp : MCP server management - prux --export : export a session as HTML - prux --list-models : list available models The complete documentation is written in Chinese and lives in assets/docs/ https://github.com/heng30/prux/blob/main/assets/docs . It is embedded at compile time and synced to the agent directory at runtime. Start at assets/docs/index.md https://github.com/heng30/prux/blob/main/assets/docs/index.md , and see assets/docs/quickstart.md https://github.com/heng30/prux/blob/main/assets/docs/quickstart.md to get up and running. Development conventions, module layering, and build details are in AGENTS.md https://github.com/heng30/prux/blob/main/AGENTS.md . The upstream alignment cadence is recorded in sync.md and migrations/ https://github.com/heng30/prux/blob/main/migrations . Windows limitations: under Git Bash on Windows, prux goes through the legacy console API used by crossterm , which implements neither the kitty keyboard protocol nor bracketed paste. Shift+Enter therefore cannot be told apart from a plain Enter use Ctrl+J to insert a newline , and pasted text arrives as ordinary keystrokes, so a multi-line paste may be submitted line by line. Running inside Windows Terminal ANSI/VT support is recommended. MIT, see LICENSE https://github.com/heng30/prux/blob/main/LICENSE .