Skip to content

Command line ​

Three command-line tools, each with its own home and credentials. COMMAND help and COMMAND help SUBCOMMAND list the options available to your configuration.

rho ​

The agent application's control plane. In the Docker stack, run it as ./cybros rho … from the installation directory.

CommandPurpose
rho server [--mode full|agent|runner] [--bind] [--port] [--display-name]Start the foreground daemon
rho setup [--nexus-url URL], rho setup model, rho setup telegram [--finish]Guided terminal setup, or one section of it
rho connect, rho disconnect, rho statusPairing and connection state
rho console --openOpen the browser page's public URL
rho run "…" [--model] [--workspace] [--runner] [--dir] [--attach] [-p] [--output-format json|stream-json] [--timeout] [--code-mode|--no-code-mode]One noninteractive request; see Terminal requests
rho models [--workload …]Usable models from Nexus
rho workspaces, rho workspaces create NAME, rho workspaces use IDWorkspaces and the saved default
rho runners, rho runners use ID|--noneEligible runners and the saved default
rho memory CONVERSATION ls|read|grep|write|edit|delete [--speaker SPEAKER_UUID]Memory documents
rho memory-review CONVERSATION status|enable|disable|resumeOptional background memory review
rho jobs CONVERSATION create|list|history|pause|resume|cancelSchedules
rho extensions list|enable|disable|configurePlugins and their settings
rho settings [JSON]Core settings
rho mcp …, rho mcp probe, rho mcp login|logoutMCP servers
rho web fetch URLWhat the web_fetch tool would read
rho telegram statusShared Telegram Connections, status and update offsets
rho t3 tokenSave or issue the T3 service bearer
rho call_tool, rho fetch, rho ps, rho logsOperator calls on a runner: a routed tool, file bytes, processes, process logs
rho agents, rho env, rho runner, rho processesManagement verbs of the shipped gems
rho version, rho doctor [--strict], rho update [--dry-run|--rollback], rho uninstallThe installation
rho-acp [--mode] [--model] [--runner], rho-acp connectThe ACP server for editors

Conversational verbs beyond run (do, say, watch, approve, …) belong to rho-dev, a development gem the distribution does not carry.

rho setup telegram configures a shared Connection and, with the daemon running, binds an existing Bot to an explicit chat/topic and owner. --finish binds a saved enabled Connection without prompting for its token. See Telegram.

rho-dev also provides rho skills to list Agent, workspace and local project skills. rho skills push DIR, rho skills show NAME and rho skills rm NAME use this rho Agent's agent/skills/ by default. Add --scope workspace to manage shared workspace skills.

./cybros ​

The stack's management script, in the installation directory.

CommandPurpose
instructionsBrowser URLs and setup steps
status, logs [nexus|rho], manager logsHealth and logs
up, stopStart and stop, preserving data
setup, setup model, setup telegramGuided terminal setup
connectRe-pair rho
rho …, cmctl …Run the bundled tools
check, update [RELEASE] [--no-backup], upgrade-status, upgrade-log, upgrade-resume ID, update-managerUpgrades; see Status, logs and upgrades
backup, backups, restore BACKUP_ID DIRECTORYSnapshots; see Backup and restore
compose …, manager …Ordinary Compose for operator repairs

Installer options: --dir, --yes, --no-start, --upgrade-manager, --help.

cmctl ​

The human operator CLI over the Platform API; see cmctl.

CommandPurpose
cmctl login --url URL --email EMAIL, cmctl logout, cmctl statusThe saved operator session
cmctl setup --url URLGuided provider and model setup
cmctl providers, cmctl provider add|edit|show|enable|disable|discover|reset ID, cmctl provider key set IDProvider connections and keys
cmctl models [--available] [--workload …], cmctl model add|edit|hide|unhide|test|invalidate|restore|remove|reset REFModel definitions
cmctl account cost-unit UNIT, cmctl account retention [DAYS|off]Account settings

CMCTL_HOME or --home DIR selects the connection; each home holds one login.

Nexus is licensed O’Saasy. The rest of the repository defaults to MIT.