rt agent
rt › agent
Hand a prompt to a Claude Code agent (herdr pane or headless) and keep the receipt
Usage
rt agent <verb> <id> [flags]
Arguments & flags
| Flag / Arg | Type | Default | Description |
|---|---|---|---|
<verb> | text | The agent action to run | |
<id> | text | For resume/show: the handoff id or session uuid | |
--repo | text | Repo path (default: the current repo) | |
--prompt | text | Initial prompt (required for headless) | |
--prompt-file | text | Read the prompt from a file (mutually exclusive with --prompt) | |
--surface | text | Where the agent runs (default herdr) | |
--model | text | Override agent.model | |
--effort | text | Override agent.effort | |
--account | text | cswap account (override agent.account) | |
--label | text | Caller's display label; used as the herdr tab name | |
--caller | text | Identifies what invoked this handoff | |
--workspace | text | herdr workspace label (default: the repo label) | |
--tab | text | herdr tab label (default: the label or handoff id) | |
--extra-args | text | Opaque extra claude arguments appended to the launch (override agent.extraArgs) | |
--json | boolean | false | Emit the record as JSON |
See code: commands/agent.ts › agent