CLI reference
The rna command connects to the same daemon as the workbench. Common commands grouped by purpose.
The CLI connects to 127.0.0.1:4317 by default; use RNA_AGENT_PORT for another port. ./rna help shows the common commands, ./rna help all lists every command, and ./rna help chat covers interactive chat only.
Help, usage hints and error messages follow the interface language: English when the interface is set to English; Chinese when it is set to Chinese or when the daemon is not running.
Daemon and service
./rna start # start the daemon in the foreground
./rna service start # hand it to LaunchAgent / systemd --user
./rna service status
./rna service restart --native # apply config changes or return to native hosting
./rna service stop
./rna service uninstall # remove only the service definition, keep all data
./rna doctor PROJECT_ID # check the service, model config, memory connection and the last 7 days of use and evolution
./rna status # daemon version and stateProjects
./rna projects
./rna project-new "Name" "Purpose and acceptance expectations" --workspace /absolute/path
./rna project-open /absolute/path
./rna project PROJECT_ID
./rna project-init PROJECT_ID # retry initialization
./rna permissions PROJECT_ID
./rna permissions-set PROJECT_ID --workspace write --background read
./rna sources PROJECT_ID # directory observation sources (read-only)
./rna source PROJECT_ID workspace pause # pauses change collection only; chat and schedules continue
./rna files PROJECT_ID [relative directory]
./rna file PROJECT_ID relative/file/path
./rna preview PROJECT_ID start relative/index.htmlSessions
./rna sessions
./rna new "Title" --project PROJECT_ID
./rna chat SESSION_ID
./rna chat --workspace "$PWD" # open or reuse the project and session for this directory
./rna run SESSION_ID "Read the project entry points and explain the structure" --jsonl --timeout 300
./rna watch SESSION_ID --jsonl
./rna interrupt SESSION_ID
./rna retry SESSION_ID # retry the last failed real turnchat, watch and run subscribe over SSE, with no polling. run waits only for the turn it submitted; failure, stop or timeout exit non-zero. A timeout or leaving the subscription never stops work in the daemon; use interrupt for that.
Dropped connections reconnect automatically with backoff from 300 ms up to 10 seconds; resuming a subscription does not resubmit messages or replay tools.
Other session commands: history, send, steer, followup, withdraw, pause, resume, status, events, budget, attach, export, compact, plan, commands. stop and reset are the global emergency stop and its release; after a release you resume paused work explicitly.
When the agent asks you something (a choice, a confirmation) you can answer in the terminal:
./rna questions SESSION_ID
./rna answer SESSION_ID INTERACTION_ID --answers-file answers.json
./rna cancel-question SESSION_ID INTERACTION_IDTool calls with an unclear outcome that need a manual check are listed by recovery SESSION_ID; record the result with recovery SESSION_ID resolve CALL_KEY completed|not-executed|abandoned "note". Reconciling never replays anything.
In-chat commands
Type /help inside chat for the full list; Tab completes. The common ones:
/status current turn, model, queue and recovery state
/model list models; /model <provider ID> <model ID> [reasoning level] switches
/steer <text> influence the current turn at the next safe boundary
/followup <text> queue for the next turn
/withdraw MESSAGE_ID withdraw a message still in the queue
/attach <path> add an attachment, sent with the next message
/attachments /detach <number> /send manage waiting attachments
/initiative on|off|mute|unmute|quiet|resume
/background list background actions; pause|resume|stop|steer|retry control one
/goal [text] view or update the project focus
/feedback <text> save project feedback
/inbox the inbox
/versions project versions
/project /sources the current project and its directory observation
/mode plan|build read-only plan mode or execution mode
/compact tidy earlier context
/permission [read|write|execute]
/export <ZIP path> export the redacted chat record
/pause /resume /retry
/recovery list operations waiting to be reconciled
/stop stop the current turn
/quit leave the CLI only; the session and background work continueSeveral pasted lines are submitted in order. While you type in an interactive terminal, proactive messages wait for a pause and your draft is kept.
Models and web search
./rna config # redacted configuration
./rna providers # model catalog
./rna provider-add --file /path/to/provider.json
./rna provider-test PROVIDER_ID
./rna provider-auth start PROVIDER_ID --method browser --wait # ChatGPT plan sign-in
./rna model-default PROVIDER_ID MODEL_ID high
./rna model-set SESSION_ID PROVIDER_ID MODEL_ID high
./rna web-config --enabled true --provider firecrawl
./rna web-testweb-config chooses the search service (fastcrw, firecrawl, tavily, brave, zhipu, bocha). Keys are not accepted in plain text on the command line: use an environment variable name or the settings screen. Choosing another service switches to its address, and the saved key is not carried over. See Configuration.
Initiative and background work
./rna initiative PROJECT_ID on|off|mute|unmute|quiet|resume
./rna frequency PROJECT_ID active|balanced|quiet
./rna background PROJECT_ID
./rna background PROJECT_ID pause ACTION_ID
./rna background PROJECT_ID steer ACTION_ID --text 'Check the official sources first'
./rna schedule PROJECT_ID list
./rna mind PROJECT_ID # project mind: lessons, agenda, commitments, notesmute pauses proactive speech and scheduled tasks, quiet pauses proactive speech for 30 minutes, and resume clears it. What each means is in Initiative.
Evolution and judgment
./rna versions PROJECT_ID
./rna version PROJECT_ID VERSION_ID
./rna evolution failures PROJECT_ID
./rna judge status # JEV configuration, latency, usage
./rna judge calibration --window 7dCapabilities
./rna capabilities
./rna project-capabilities PROJECT_ID
./rna capability-inspect PROJECT_ID /absolute/install.json
./rna capability-install PROJECT_ID /absolute/install.json
./rna capability-assign PROJECT_ID /absolute/assign.json
./rna capability-remove PROJECT_ID /absolute/remove.json
./rna marketplace search "keywords" --provider skills-sh --limit 5Memory, maintenance and recovery
./rna memory-config --backend embedded
./rna memory PROJECT_ID health|initialize|list|browse|search|read|write
./rna maintenance status
./rna maintenance backup
./rna recovery status
./rna endurance start --keep-awakememory-config options are in Memory; maintenance and recovery are in Updates and recovery.
Subagents
The main conversation can hand a self-contained piece of work to a subagent. Three read-only helpers investigate, plan and review; a worker makes changes in its own worktree.
Skills and MCP
Install skill packages and MCP servers, assign them to projects, or just ask Rna to install them in a conversation.