rho-coding-agent 1.32.0

A lightweight agent harness inspired by Pi
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Rho

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/matthewyjiang/rho)

Rho is a lightweight agent harness inspired by Pi, built in Rust.

[![Rho terminal UI showing a code inspection, Rust edit, and focused test run](docs/assets/rho-ui-demo.svg)](https://matthewyjiang.github.io/rho/interactive-tui)

## Why Rho

- **Lightweight**: Compare the CLI process overhead and memory usage with other coding harnesses:
![CLI startup time and peak RSS for rho versus Codex, Claude Code, OpenCode, and Pi without extensions](docs/assets/cli-overhead.svg)

- **Bring your own provider**: OpenAI, Kimi, xAI, Anthropic, Gemini, Copilot, Ollama, Ollama Cloud, OpenRouter, and more. Use API keys or subscription plans.
- **Embeddable SDK**: Build headless Rust agents with explicit providers, tools, sessions, and cancellation.

## Works without a plugin store

Rho is small on purpose. The pieces power users usually wire up later are already in the binary.

- **Built-in [RTK](https://github.com/rtk-ai/rtk)**: when the `rtk` binary is on your PATH, Rho rewrites shell commands for you. No `rtk init`, no host hooks. Docs: [RTK](https://matthewyjiang.github.io/rho/integrations/rtk).
- **Built-in [Herdr](https://github.com/herdrdev/herdr)**: under Herdr, Rho reports agent state, supports pane attach, and handles host image paste. No extra integration. Docs: [Herdr](https://matthewyjiang.github.io/rho/integrations/herdr).
- **Coding tools included**: read, edit, search, shell, web, skills, and workflows ship with Rho. Install, sign in, work.

## Install

Install on macOS and Linux:

```bash
curl -fsSL https://matthewyjiang.github.io/rho/install.sh | sh
```

On Windows PowerShell:

```powershell
irm https://matthewyjiang.github.io/rho/install.ps1 | iex
```

Or with Scoop:

```powershell
scoop bucket add rho https://github.com/matthewyjiang/rho
scoop install rho
```

Or install from crates.io with Cargo:

```bash
cargo install rho-coding-agent
```

## Usage

```bash
rho
```

For one-off prompts:

```bash
rho run "summarize this repository"
```

For a deterministic multi-step graph, see the
[workflow guide](https://matthewyjiang.github.io/rho/workflows).

## Docs

Read the documentation at <https://matthewyjiang.github.io/rho/>.

## Development

```bash
cargo build
cargo test
```