--agent, -a | text | required | Python file defining ‘agent’ or ‘create_agent()’. |
--instruction, -i | text | | The instruction to run. |
--instruction-file, -f | text | | Read the instruction from a file, or ’-’ for stdin. |
--session-id | text | | Session to run in (default: new). |
--run-id | text | | Run ID (default: generated). |
--tag | text | | Label recorded on the trace. Repeatable. |
--provenance | text | | Trace provenance, e.g. trial_id=abc. Unknown keys go to external_ids. |
--approval-mode | stop | allow | deny | scripted | stop | How approvals the policy asks for are answered. |
--approvals-file | text | | JSON rules for —approval-mode scripted. |
--budget-mode | stop | deny | stop | stop: exit when a budget runs out; deny: end the run cleanly. |
--timeout | float | | Deadline in seconds for the whole run. |
--max-approval-rounds | integer | 20 | Most pause-and-resume cycles before giving up. |
--output-dir, -o | text | | Write result.json and trajectory.json here. |
--json | flag | | Print result.json to stdout. |