CLI reference
Run a pinned coding agent non-interactively inside a Kiste.
| Argument | Description |
|---|---|
NAME | Kiste name, current, or self. |
PROMPT... | Prompt words passed losslessly to the agent. |
| Option | Description |
|---|---|
--provider PROVIDER | Stable provider contract supplied by the universal image. Values: codex, claude. |
--model MODEL | Provider model identifier. |
--reasoning-effort REASONING_EFFORT | Provider-specific reasoning effort. Values: minimal, low, medium, high, xhigh, max. |
--access ACCESS | Agent execution policy inside the isolated Kiste. Values: read-only, workspace-write, full. Default: full. |
--max-budget-usd USD | Hard spend cap in US dollars for this one run (claude only) |
--id ID | Stable command UUID for history and interruption. |
Examples
The prompt is executed without a shell. Provider credentials come from the selected Kiste environment; local provider credentials are never copied automatically.
Global options such as --json work with every command; see the CLI overview.