๐Ÿ”ฅ ฯ€ + ฯ = pirho ยท Minimal Coding Agent in Rust ยท Inspired by pi.dev

The minimal coding agent
built for extensibility.

Zero telemetry, zero bloated runtimes. 8 native agent tools, interactive session picker, standard MCP integration, and one-shot lifecycle hooks.

$ cargo install rho
Privacy First

Zero telemetry. Completely private.

rho collects nothing. No telemetry, no background analytics, no tracking pixels, and no phone-home pings.

๐Ÿ”’

Zero Telemetry & Analytics

rho contains zero analytics SDKs, crash reporters, or tracking code. We do not monitor, log, or transmit your commands, prompts, or usage habits.

๐ŸŒ

Direct Provider Connections

Your prompts, code, and completions travel directly from your machine to your chosen AI provider (Anthropic, OpenAI, Gemini, Ollama, etc.). No intermediary proxy servers or relays.

๐Ÿ’ป

100% Local Data Storage

All configuration files, API credentials, session transcripts, branch trees, and context caches reside exclusively on your local disk in ~/.config/rho and ~/.local/share/rho.

Extensibility

Standard MCP tools and zero-daemon lifecycle hooks

Connect external capabilities using open Model Context Protocol servers, and guard execution with deterministic one-shot process hooks in any programming language.

๐Ÿ”Œ

Universal MCP Servers

Connect any community or custom MCP tool server via standard JSON in ~/.agents/mcp.json or workspace .mcp.json. Works across Claude Desktop, Cursor, Zed, and rho.

โšก

Zero-Daemon Lifecycle Hooks

Drop executable scripts into .agents/hooks/ (Bash, Python, Node, Rust). Intercept tool calls, rewrite arguments, repair errors, or halt execution without long-lived background daemons.

๐Ÿ›ก

In-Process Guard & Safety

Delegate shell command safety to an automated local guard model (qwen2.5-coder:7b via Ollama). Benign commands run automatically; risky operations pause for review with full fail-closed safety.

Core Engine

Built-in CLI capabilities

rho ships with powerful command-line features for interactive coding, headless scripting, session recovery, and configuration management.

Interactive Session Picker

Browse previous coding sessions interactively with rho -r, resume with rho --resume <id>, or continue the working directory's last session with rho -c.

# Interactive picker
rho -r

# Continue last session
rho -c

MCP Server Management

Manage your external tool servers directly through the CLI. Audit connections, test discovery, and self-update rho.

rho mcp list
rho mcp test filesystem
rho mcp add db "https://mcp.example.com"
rho update

Model & Config Inspection

Inspect live models and capabilities with rho models, view or edit configuration keys with rho config, or run one-shot prompts with rho -p.

rho models
rho config
rho -p "audit dependencies"

Headless & IDE RPC Server

Embed rho into IDE extensions or remote harnesses with rho --mode rpc. Concurrent JSON-lines server supporting streaming, mid-turn steering, and interactive tool approval dialogs.

# Launch stdio RPC mode
rho --mode rpc

# Non-blocking concurrent turns

Conversation Trees & DAG History

Explore turn history with /tree, label key checkpoints, rewind to prior turns with /rewind, or fork clean sub-branches with /fork.

# Interactive DAG tree navigation
/tree

# Rewind or fork from turn
/rewind 4
/fork <node-id>

Adaptive Context Compaction

Intelligent context monitoring that automatically triggers compaction before token exhaustion. Features atomic split-turn protection, cumulative file ledgers, and bounded summary limits.

# Manual compaction command
/compact "focus on tests"

# Proactive auto-compact at threshold
Native Tooling

8 native agent tools, zero setup

rho includes native tools specifically designed and bounded for coding agents.

๐Ÿ“–

read

Safe offset/limit chunking, line numbering, and automatic image sniffing.

โœ๏ธ

write

Creates or overwrites files with automatic missing directory creation.

๐ŸŽฏ

edit

Targeted, exact text replacements with strict single-match verification.

๐Ÿš

bash

Process group isolation, timeout watchdog, and binary output sanitization.

๐Ÿ“‚

fd

Fast gitignore-aware workspace file discovery with smart-case regex.

๐Ÿ”

rg

Line-oriented content search, skips binaries, and bounds large result sets.

๐ŸŒ

web_search

Structured web search results and domain-filtered URL discovery.

๐Ÿ“ฅ

web_fetch

Clean extraction of markdown, HTML, GitHub diffs, YouTube transcripts, and visual charts/images.

๐Ÿ”ฅ ฯ€ + ฯ = pirho

For developers who like playing with fire.

In Greek, ฯ€ (pi) and ฯ (rho) join together to form ฯ€ฯ…ฯ (pyr) โ€” fire. rho was built with deep admiration for the clean, keyboard-first ethos of pi.dev, forging that same minimalist spirit into native, bare-metal Rust. Direct provider links, aligned slash commands, instant tool execution, and zero telemetry. When ฯ€ meets ฯ, you get pirho: high-octane agency for developers who aren't afraid of sparks.

โšก Native Rust Speed ๐ŸŽฏ pi.dev Ergonomics ๐Ÿ”’ Zero Telemetry ๐Ÿ›ก Fail-Closed Hooks ๐ŸŒ Iroh P2P Pairing
ฯ€ pi.dev Clean Ethos
+
ฯ rho Native Rust
=
๐Ÿ”ฅ pirho Playing with Fire
Ecosystem Catalog

Popular MCP servers and hook recipes

Open standards and verified recipes to extend rho without custom runtimes.

๐Ÿ”Œ

GitHub (MCP)

Query issues, review pull requests, and inspect commit history via standard Model Context Protocol.

@modelcontextprotocol/server-github
๐Ÿ“

Filesystem (MCP)

Bounded local filesystem access outside the current workspace with standard security policies.

@modelcontextprotocol/server-filesystem
๐Ÿ›ก

Command Guard (Hook)

A simple 10-line POSIX shell script in .agents/hooks/on_tool_call that blocks destructive bash commands.

.agents/hooks/on_tool_call
Browse All Tools & Recipes โ†’