Rye supervision workbench

CLI reference

Common Rye commands for setup, diagnostics, supervision, wrapping, and audit review.

Use rye --help and rye <command> --help for the full command surface. Commands such as rye status, rye doctor, rye auth status, and rye app tools support --json for scripting.

Status

Show local daemon, proxy, workspace, device, and policy state:

exec:bash

rye status

Live dashboard and tool detection

Open the live terminal dashboard (available in 0.10.0 and later):

exec:bash

rye top

It shows daemon vitals, detected coding tools, recent API traffic, events, and database statistics. Panels refresh every two seconds. Use Tab/Shift+Tab to change panels, j/k to scroll, r to refresh, ? for help, and q/Esc to quit.

Scan for installed coding tools:

exec:bash

rye app tools
rye app tools --json

Detection reports installed tools; it does not mean those tools are wrapped or their traffic is flowing through Rye.

Doctor

Run local diagnostics:

exec:bash

rye doctor

Use this after install, after proxy setup, and after wrapping an agent. Apply safe local fixes with rye doctor --fix. This leaves global shell proxy variables unset by default. See proxy routing scope for explicit global configuration.

Authenticate

Start device-code login:

exec:bash

rye auth login

Use a dashboard-issued one-time token instead:

exec:bash

rye auth login --bootstrap-token

Check or end the local session:

exec:bash

rye auth status
rye auth status --json
rye auth logout

Start supervision

Start the local proxy and install CA trust:

exec:bash

rye up --install-ca --intercept-patterns openai.com,anthropic.com,claude.com,chatgpt.com,cursor.com,windsurf.com

Stop supervision

Stop the local proxy and restore Rye-managed proxy settings:

exec:bash

rye down

Daemon and CA management

exec:bash

rye daemon status
rye daemon logs
rye daemon restart
rye ca path
rye ca install

Daemon commands manage the background process. CA commands inspect or install the certificate used for HTTPS interception.

Inspect history

Inspect recent supervised traffic:

exec:bash

rye history --last 1h

Wrap agents

Launch common coding agents through Rye:

exec:bash

rye wrap claude

exec:bash

rye wrap codex

Inspect or manage persistent shims:

exec:bash

rye app list
rye app doctor
rye app unwrap claude codex

Install persistent shims:

exec:bash

rye app wrap claude

exec:bash

rye app wrap codex