Rho

Appearance

Installation ​

Install the latest prebuilt Rho binary 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

The macOS and Linux installer writes to $HOME/.local/bin by default. The Windows installer writes to %LOCALAPPDATA%\Programs\rho\bin and adds that directory to your user PATH.

The credential backend stays unset, and Rho uses the OS store until you choose. The first interactive /login asks. Set RHO_CREDENTIAL_STORE=os|file during install, or later run rho credential-store set os or rho credential-store set file, to skip that picker. file is a local file protected by filesystem permissions, not encrypted at rest. See where credentials live.

bash
curl -fsSL https://matthewyjiang.github.io/rho/install.sh | RHO_CREDENTIAL_STORE=file sh
powershell
$env:RHO_CREDENTIAL_STORE = "file"; irm https://matthewyjiang.github.io/rho/install.ps1 | iex

You can also install Rho with Scoop on Windows:

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

Or install the manifest directly:

powershell
scoop install https://raw.githubusercontent.com/matthewyjiang/rho/main/bucket/rho.json

rho update recognizes custom Scoop roots from SCOOP and SCOOP_GLOBAL, as well as the default Scoop layout. It prints the Scoop update command, including -g for global installs, rather than replacing a Scoop-managed binary with the standalone installer.

To use a different directory, set RHO_INSTALL_DIR:

bash
curl -fsSL https://matthewyjiang.github.io/rho/install.sh | RHO_INSTALL_DIR=/usr/local/bin sh
powershell
$env:RHO_INSTALL_DIR = "$env:LOCALAPPDATA\Programs\rho\bin"; irm https://matthewyjiang.github.io/rho/install.ps1 | iex

To install a specific release, set RHO_VERSION. Accepted forms include v0.9.0, 0.9.0, and the full release tag rho-coding-agent-v0.9.0:

bash
curl -fsSL https://matthewyjiang.github.io/rho/install.sh | RHO_VERSION=v0.9.0 sh
powershell
$env:RHO_VERSION = "v0.9.0"; irm https://matthewyjiang.github.io/rho/install.ps1 | iex

If your platform has no prebuilt binary, install from crates.io with Cargo:

bash
cargo install rho-coding-agent

Run Rho directly:

bash
rho

If Cargo's bin directory is not on your PATH, add it before running the interactive TUI or automation commands:

bash
export PATH="$HOME/.cargo/bin:$PATH"

Claude Code binary (optional) ​

Agent definitions with runtime: claude-cli need the claude binary on PATH. Rho does not ship or install it. Install Claude Code from Anthropic's docs (setup), for example:

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex

Confirm with claude --version. Sign in from Rho with /login claude-code (terminal handoff; Claude Code stores the credential). Details: Claude Code runtime sign-in and Claude Code as a delegated runtime.

Cursor Agent binary (optional) ​

Agent definitions with runtime: cursor need the cursor-agent binary on PATH. Rho does not ship or install it. Install Cursor Agent from Cursor's docs, then confirm with cursor-agent --version. Sign in from Rho with /login cursor (terminal handoff; Cursor stores the credential in ~/.cursor). Details: Cursor Agent runtime sign-in.

Next, configure authentication and models. To embed Rho as a headless Rust library instead of installing the CLI, start with SDK installation and support.