[ Documentation ]
rnx agent

rnx agent

rnx agent

Manage attached project directories and the agent sessions running inside them. Session-lifecycle commands (start, prompt, watch, end) route through the bridge daemon, which owns the single FIFO reader per session so concurrent cli watches + electron UI subscribers no longer steal bytes from each other. Disk-only inspection commands (projects, sessions, paths, transcript) read attached-project state directly, no daemon needed.

terminal
rnx agent attach <dir> [--name <label>] [--provider codex|claude]
rnx agent projects
rnx agent project show <id>
rnx agent project remove <id>
rnx agent sessions [--project <id>] [--all]
rnx agent start <projectId> [--provider codex|claude]
rnx agent prompt <sessionId> "<text>"
rnx agent watch <sessionId>
rnx agent transcript <sessionId>
rnx agent end <sessionId>
rnx agent paths

Options

flagdescription
--name <label>human-readable label when attaching a project
--provider <id>agent backend: codex (default) or claude; used by attach + start
--project <id>filter sessions to a specific attached project
--allinclude ended sessions (sessions defaults to active only)

Examples

terminal
rnx agent attach ~/projects/three-punch --name 3pc
rnx agent projects
rnx agent project show 3pc
rnx agent start 3pc --provider claude
rnx agent prompt <sessionId> "fix the failing scroll test"
rnx agent watch <sessionId>
rnx agent sessions --all
rnx agent transcript <sessionId>
rnx agent end <sessionId>
rnx agent paths