CLI reference
kusaw agent-args
Print or run the agent argv the built-ins use
kusaw agent-args
Print or run the agent argv the built-ins use
Usage
kusaw agent-args [--provider claude-code|cursor] --preset <edit|read_only|interview> [flags]Flags
| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--add-dir | stringArray | Directory passed as --add-dir (repeatable, order kept) | ||
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--connectors | bool | false | Merge factory-connectors into --mcp-config when KUSAW_CONNECTOR_SOCKET is set | |
--exec | bool | false | Run the argv instead of printing it | |
--factory | string | factory name from kusaw list | ||
--first-message-file | string | Interactive first message file | ||
--fork | bool | false | Pass --fork-session with --resume-session | |
--help | -h | bool | false | help for agent-args |
--interactive | bool | false | Build an interactive argv (interview only) | |
--model | string | Passed as --model when set | ||
--preset | string | edit, read_only, or interview | ||
--protocol-events | bool | false | Translate stream-json to protocol v2 events (headless --exec only) | |
--provider | string | claude-code or cursor | ||
--repo-capabilities | string | Repo label whose approved items isolation flags to add | ||
--result-text-file | string | Write the session's final text here (needs --protocol-events) | ||
--resume-session | string | Pass --resume so a custom step continues a session | ||
--system-prompt-file | string | File sent as --append-system-prompt |
Exit codes
| Code | Name | Description |
|---|---|---|
| 0 | ok | Success. |
| 1 | error | Runtime error. |
| 2 | usage | Usage or validation error. |
| 3 | rejected | Control request rejected; the error string is printed verbatim. |
| 4 | not picked up | Control request not picked up within the wait time while serve runs. |
Example
kusaw agent-args --preset read_only