---
source: crates/octl-cli/tests/help_json.rs
assertion_line: 66
expression: value
---
{
"schema_version": 1,
"data": {
"schema_version_help": 3,
"command": "orchestratectl",
"about": "Orchestrate AI-agent workflows: worktrees, fan-out, orchestrate, llm-skills.",
"aliases": [],
"hidden": false,
"deprecated": false,
"version": "[VERSION]",
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl discussion",
"about": "List, show, or resolve discussions for a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl discussion list",
"about": "List discussions for a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "status",
"long": "status",
"long_aliases": [],
"short_aliases": [],
"help": "Filter by status (`open` or `resolved`). When omitted, all are listed",
"value_names": [
"STATUS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [
"open",
"resolved"
],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl discussion resolve",
"about": "Resolve a discussion — emits `discussion.resolved`, updates the projection. Idempotent on `--choice`; conflict on `--choice` change",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "choice",
"long": "choice",
"long_aliases": [],
"short_aliases": [],
"help": "Resolution choice (free-form string from the agent operator)",
"value_names": [
"CHOICE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"help": "Print the would-be event and exit 0 without touching the filesystem",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"help": "Dedup token for retries (e.g. supervisor crash + replay)",
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "note",
"long": "note",
"long_aliases": [],
"short_aliases": [],
"help": "Optional human-readable note recorded with the resolution",
"value_names": [
"NOTE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "discussion_id",
"value_names": [
"DISCUSSION_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl discussion show",
"about": "Show a single discussion projection",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "discussion_id",
"value_names": [
"DISCUSSION_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl doctor",
"about": "Read-only self-diagnostic: validate schema, skill-sync, deps, config, and data integrity. `--fix` applies the safe subset",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"help": "With `--fix`, print the planned fixes via the §11 planning envelope and apply nothing",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "fix",
"long": "fix",
"long_aliases": [],
"short_aliases": [],
"help": "Apply the safe subset of `fix_suggestion`s after running the checks. Opt-in per invocation; never the default (§18)",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
},
{
"command": "orchestratectl event",
"about": "Read (`tail`) or append (`create`) events on a run's event log",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl event create",
"about": "Append one event to a run's `events.jsonl` and update projections",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"help": "Print the would-be event + projection plan and exit 0 without touching the filesystem",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "from_file",
"long": "from-file",
"long_aliases": [],
"short_aliases": [],
"help": "JSON file containing the event's `data` payload",
"value_names": [
"FROM_FILE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"help": "Dedup token — a repeat call with the same key returns the existing event's `seq` instead of appending again",
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "kind",
"long": "kind",
"long_aliases": [],
"short_aliases": [],
"help": "Event kind (see design.md §1.4 for the closed MVP set)",
"value_names": [
"KIND"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "node_id",
"long": "node-id",
"long_aliases": [],
"short_aliases": [],
"help": "Node-id for node-scoped kinds (`node.*`, `child.spawned`)",
"value_names": [
"NODE_ID"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"help": "Target run-id (`<root>/runs/<run-id>` must exist)",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl event tail",
"about": "Stream events from a run's `events.jsonl`. Tails to EOF and exits (or follows the file with `--follow`, polling every 500ms)",
"long_about": "Stream events from a run's `events.jsonl`. Tails to EOF and exits (or follows the file with `--follow`, polling every 500ms).\n\nJSONL mode emits one object per line and terminates with exactly one `{\"event\":\"result\"|\"cancelled\",\"schema_version\":1, ...}` envelope. With `--follow`, SIGINT exits 130. SIGTERM also exits 130 (known divergence from AGENTS-AI-FIRST-CLI §12's 143 — `ctrlc` does not surface the signal value; see comment in `tail.rs`).",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "follow",
"long": "follow",
"long_aliases": [],
"short_aliases": [],
"help": "Keep polling for new events after reaching EOF",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "from_seq",
"long": "from-seq",
"long_aliases": [],
"short_aliases": [],
"help": "Emit only events with `seq >= from_seq` (default 0 = all)",
"value_names": [
"FROM_SEQ"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"0"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help (see more with '--help')",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "to_file",
"long": "to-file",
"long_aliases": [],
"short_aliases": [],
"help": "Write the stream to this file instead of stdout. Truncated on open without `--follow`, append-mode with `--follow`. Must not point at the run's own `events.jsonl`. The format is the global `--output` selection (text or jsonl)",
"value_names": [
"TO_FILE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl harness",
"about": "Code-harness tooling. `bakeoff` runs one brief through every available agent-loop adapter and compares them (behind the seam — not part of `run create`)",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl harness bakeoff",
"about": "Run ONE coding brief through every available `CodeHarness` adapter (aider, claude, claude-deepseek, pi) in isolated throwaway git repos and print a comparison. Invokes the REAL agents; unavailable adapters are reported, not errored",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "brief",
"long": "brief",
"long_aliases": [],
"short_aliases": [],
"help": "Path to the brief file. Plain text is the brief verbatim; a JSON `{\"brief\":..,\"checks\":[..],\"files\":[..]}` also carries self-checks and a declared file scope",
"value_names": [
"FILE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "files",
"long": "files",
"long_aliases": [],
"short_aliases": [],
"help": "Seed/scope files copied into each throwaway repo (repeatable). Existing files are committed as the shared starting state; names that don't exist are declared scope (targets to create)",
"value_names": [
"PATH"
],
"takes_value": true,
"multiple": true,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": true,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "only",
"long": "only",
"long_aliases": [],
"short_aliases": [],
"help": "Restrict to these adapters (comma-separated or repeated). Omit for all. Known: aider, claude, claude-deepseek, pi",
"value_names": [
"NAMES"
],
"takes_value": true,
"multiple": true,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": true,
"multi_value": false,
"value_delimiter": ",",
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "timeout",
"long": "timeout",
"long_aliases": [],
"short_aliases": [],
"help": "Per-adapter wall-clock ceiling in seconds (default 600)",
"value_names": [
"SECONDS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
}
]
},
{
"command": "orchestratectl node",
"about": "List nodes, show a node, or submit a structured terminal report",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl node list",
"about": "List nodes belonging to a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "status",
"long": "status",
"long_aliases": [],
"short_aliases": [],
"help": "Filter by status (e.g. `running`, `done`)",
"value_names": [
"STATUS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl node report",
"about": "Agent self-submission of a structured terminal report (§7.3)",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"help": "Validate the payload and exit 0 without writing anything to the run's events.jsonl or projection files",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "from_file",
"long": "from-file",
"long_aliases": [],
"short_aliases": [],
"help": "JSON file containing the §7.3 report payload",
"value_names": [
"FROM_FILE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"help": "Dedup token — a repeat call with the same key returns the existing event's `seq` instead of appending again",
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "node_id",
"value_names": [
"NODE_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl node show",
"about": "Print one node's JSON projection",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "node_id",
"value_names": [
"NODE_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl pipeline",
"about": "Spec-driven code pipeline (design §6). `run` drives ONE feature end-to-end — spec(Opus) → code[claude-deepseek] → floor-gate → verify(Opus) → merge — as an ADDITIVE command (it does not touch `run create` / the supervisor). Bold-to-live: it invokes real agents and really merges, gated by the deterministic floor",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl pipeline run",
"about": "Run one feature through the whole pipeline end-to-end",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "chunk_timeout",
"long": "chunk-timeout",
"long_aliases": [],
"short_aliases": [],
"help": "Per-chunk wall-clock ceiling for the code harness, in seconds",
"value_names": [
"SECONDS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "clippy_cmd",
"long": "clippy-cmd",
"long_aliases": [],
"short_aliases": [],
"help": "Base `cargo clippy` invocation the floor captures via `--message-format=json` (default `cargo clippy`)",
"value_names": [
"CMD"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "file_scope_slack",
"long": "file-scope-slack",
"long_aliases": [],
"short_aliases": [],
"help": "How many out-of-scope changed files the floor tolerates before it fails the file-scope gate (default 0)",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"0"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "files",
"long": "files",
"long_aliases": [],
"short_aliases": [],
"help": "Optional file-scope hints handed to the spec stage (repeatable)",
"value_names": [
"PATH"
],
"takes_value": true,
"multiple": true,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": true,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "intent",
"long": "intent",
"long_aliases": [],
"short_aliases": [],
"help": "The intent — what must exist. A literal string, a path to a file, or `@path` (all read the same way; a leading `@` or an existing file path loads the file, else the value is the intent verbatim)",
"value_names": [
"STR|FILE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "keep",
"long": "keep",
"long_aliases": [],
"short_aliases": [],
"help": "Keep worktrees/branches after the run (skip teardown) for debugging",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_build_concurrency",
"long": "max-build-concurrency",
"long_aliases": [],
"short_aliases": [],
"help": "How many independent chunks in one dependency wave may build concurrently (design §6 VAIHE 2). Omit for the default (1 = strictly sequential); a value `> 1` builds no-dependency-path chunks in parallel worktrees, then merges them deterministically with the floor re-checked at each merge. Bounded at runtime by the `--max-processes` budget",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_cost_usd",
"long": "max-cost-usd",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: hard cost ceiling in USD, summed from harness usage (design §9). Omit for the default ($10); 0 disables the cost breaker",
"value_names": [
"USD"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_fix_iterations",
"long": "max-fix-iterations",
"long_aliases": [],
"short_aliases": [],
"help": "Circuit-breaker: max verify→triage→fix cycles after the code stage first goes green (design §8/§9). Omit for the default (2); 0 makes a failed verify terminal",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_identical_failures",
"long": "max-identical-failures",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: abort when the SAME failure (same chunk, tier, and findings) is observed this many times (design §9). Omit for the default (3); 0 disables the repeated-failure breaker",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_processes",
"long": "max-processes",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: hard cap on agent invocations spawned across the run (design §9). Omit for the default (50); 0 disables it",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_promotions",
"long": "max-promotions",
"long_aliases": [],
"short_aliases": [],
"help": "Adaptive promotion: max `PROMOTE_TIER` promotions per chunk on repeat-fail (design §3) — a stuck chunk is re-run at the next model tier up before the breaker gives up. Omit for the default (1); 0 disables promotion",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_recode_per_chunk",
"long": "max-recode-per-chunk",
"long_aliases": [],
"short_aliases": [],
"help": "Circuit-breaker: max `RE_CODE` re-attempts per chunk on a floor / harness failure before the repeated-failure breaker stops the loop (design §8/§9). Omit for the default (1); 0 disables per-chunk re-coding",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_respec",
"long": "max-respec",
"long_aliases": [],
"short_aliases": [],
"help": "Circuit-breaker: max `TRIGGER_RE_SPEC` events across the run (design §7/§9). Omit for the default (1); 0 disables re-spec",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_storage_mb",
"long": "max-storage-mb",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: hard cap on scratch-workdir size, in MiB (design §9). Omit for the default (2048); 0 disables it",
"value_names": [
"MB"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_total_tokens",
"long": "max-total-tokens",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: hard total-token ceiling (design §9). Omit for the default (2,000,000); 0 disables the token breaker",
"value_names": [
"N"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_wall_time",
"long": "max-wall-time",
"long_aliases": [],
"short_aliases": [],
"help": "Resource circuit-breaker: hard wall-clock ceiling for the whole run, in seconds (design §9). Omit for the default (3600); 0 disables it",
"value_names": [
"SECONDS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "repo",
"long": "repo",
"long_aliases": [],
"short_aliases": [],
"help": "Repository to operate on (default: current directory)",
"value_names": [
"PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "slug",
"long": "slug",
"long_aliases": [],
"short_aliases": [],
"help": "Override the derived feature slug (else slugified from the intent)",
"value_names": [
"SLUG"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "source_branch",
"long": "source-branch",
"long_aliases": [],
"short_aliases": [],
"help": "Branch the feature forks from and (on success) merges back to",
"value_names": [
"BRANCH"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "test_cmd",
"long": "test-cmd",
"long_aliases": [],
"short_aliases": [],
"help": "Base `cargo test` invocation the floor enumerates + runs per-binary for its structured, target-qualified test snapshot (default `cargo test`)",
"value_names": [
"CMD"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "workdir",
"long": "workdir",
"long_aliases": [],
"short_aliases": [],
"help": "Scratch directory for worktrees + artifacts (default: a temp dir under the system temp keyed by slug)",
"value_names": [
"PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
}
]
},
{
"command": "orchestratectl run",
"about": "Create, list, show, wait on, cancel, merge, or reattach a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl run cancel",
"about": "Cancel a run: synthesize terminal `node.report` for non-terminal nodes, emit `run.status: cancelled`. Idempotent",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "note",
"long": "note",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"NOTE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl run create",
"about": "Create a new run. Top-level when `--parent-*` flags are absent, child-spawn when both are set (mutually required)",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "agent_startup_timeout",
"long": "agent-startup-timeout",
"long_aliases": [],
"short_aliases": [],
"help": "Seconds create.sh waits for the freshly launched agent to become discoverable before giving up (forwarded as `--agent-startup-timeout <seconds>`). Range 1–600. Defaults to 90 — higher than create.sh's own 30s default because octl spawns are frequently part of high-fan-out batches that self-load the host; bump it further on an already-loaded box",
"value_names": [
"AGENT_STARTUP_TIMEOUT"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"90"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "harness",
"long": "harness",
"long_aliases": [],
"short_aliases": [],
"help": "Code harness to launch the worker under: `claude` (default) | `pi` | `aider` | `claude-deepseek`. Overrides `ORCHESTRATECTL_HARNESS`, the `config.toml` `[harness]` default, and the built-in default (in that precedence order). A non-claude harness is forwarded to create.sh as `--agent <name>` (→ `workmux add -a`), so the selected agent must be configured in workmux. Recorded on the run and shown by `run show` / `run list --json`",
"value_names": [
"HARNESS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "headless",
"long": "headless",
"long_aliases": [],
"short_aliases": [],
"help": "Spawn the worker's tmux window in a detached \"headless\" session instead of the foreground one, so a campaign of many spawns does not clutter the user's window list. Attach later with `tmux attach -t headless`. Opt-in; default is foreground",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "kind",
"long": "kind",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"KIND"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [
"code",
"spinoff",
"orchestrated",
"research",
"technical-decision",
"make-skill",
"fan-out",
"bugfix",
"orchestrate"
],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "layout",
"long": "layout",
"long_aliases": [],
"short_aliases": [],
"help": "Workmux layout name; forwarded to create.sh as `-l <name>`",
"value_names": [
"LAYOUT"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "no_hooks",
"long": "no-hooks",
"long_aliases": [],
"short_aliases": [],
"help": "Skip workmux post-create hooks; forwarded to create.sh",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "notify",
"long": "notify",
"long_aliases": [],
"short_aliases": [],
"help": "Shell command the supervisor runs when this run reaches a terminal state (`done | failed | cancelled`), BEFORE teardown. Runs via `sh -c <cmd>` with `OCTL_RUN_ID`, `OCTL_STATUS`, `OCTL_SUMMARY`, `OCTL_RUN_KIND`, and `OCTL_RUN_TITLE` in the environment — so a spawning session can learn of completion without polling (e.g. append a line to a file the harness watches, or post a desktop notification). At-least-once: deduped on a durable `run.notified` marker (so the healthy path fires once), but a supervisor crash in the window between firing and recording the marker re-fires on restart — a duplicate is preferred over a missed notification, so the command should tolerate running more than once",
"value_names": [
"NOTIFY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "parent_node_id",
"long": "parent-node-id",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"PARENT_NODE_ID"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [
"parent_run_id"
],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "parent_run_id",
"long": "parent-run-id",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"PARENT_RUN_ID"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [
"parent_node_id"
],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "prompt_file",
"long": "prompt-file",
"long_aliases": [],
"short_aliases": [],
"help": "Path to a prompt file (instead of inlining via --task). Used as-is and handed to create.sh",
"value_names": [
"PROMPT_FILE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "skip_materialize",
"long": "skip-materialize",
"long_aliases": [],
"short_aliases": [],
"help": "**Test-only.** Skip the create.sh shell-out and supervisor spawn; produce only the on-disk run skeleton (manifest + run.created event). Hidden from `--help`. Never set this in production — the run will be missing its worktree, tmux window, and supervisor",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": true,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "source_branch",
"long": "source-branch",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"SOURCE_BRANCH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "source_repo",
"long": "source-repo",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"SOURCE_REPO"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "task",
"long": "task",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"TASK"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [
"prompt_file"
],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "title",
"long": "title",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"TITLE"
],
"takes_value": true,
"multiple": false,
"required": true,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "tmux_session",
"long": "tmux-session",
"long_aliases": [],
"short_aliases": [],
"help": "Explicit tmux session name for the worker's window. Implies headless placement and overrides `--headless`'s default session name. Forwarded to create.sh / workmux as `--parent-session <name>`",
"value_names": [
"TMUX_SESSION"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
},
{
"command": "orchestratectl run list",
"about": "List runs on disk",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "kind",
"long": "kind",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"KIND"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "status",
"long": "status",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"STATUS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
},
{
"command": "orchestratectl run merge",
"about": "Merge a worktree run's branch back to its source, then submit the terminal `node.report` so the supervisor winds the run down and tears the worktree/window/branch down. Owns the full merge lifecycle: rebase + merge (via the bundled merge backend) AND the report, in one call",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "confirm_interactive",
"long": "confirm-interactive",
"long_aliases": [],
"short_aliases": [],
"help": "Human-reviewer acknowledgement, required to merge a `code` run (the `/worktree-merge` workflow supplies it). No-op for other kinds",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": true,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"help": "Resolve inputs and report the planned merge without running it or appending any event",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "node_id",
"long": "node-id",
"long_aliases": [],
"short_aliases": [],
"help": "Reporting node id (defaults to `n-0001`)",
"value_names": [
"NODE_ID"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "report_file",
"long": "report-file",
"long_aliases": [],
"short_aliases": [],
"help": "Optional §7.3 report payload (JSON file) to submit on a clean merge. Lets an autonomous kind carry its rich `discussion_items` / `spinoff_proposals` / `wrap_up_recommendations` in the same call. `run merge` stamps it `via: \"explicit-merge\"`. Omit it for a minimal `{success, summary}` report",
"value_names": [
"REPORT_FILE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "source",
"long": "source",
"long_aliases": [],
"short_aliases": [],
"help": "Merge target branch. Defaults to the run's recorded `source_branch`, then to main/master auto-detection",
"value_names": [
"SOURCE"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl run reattach",
"about": "Restart the run's supervisor process. Refuses if the recorded supervisor PID is still alive. Spawns `orchestratectl supervise <run-id>` detached with stdout/stderr → `supervisor.stderr.log`",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_iter",
"long": "max-iter",
"long_aliases": [],
"short_aliases": [],
"help": "Pass `--max-iter <n>` to the spawned supervisor (test-only)",
"value_names": [
"MAX_ITER"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": true,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "once",
"long": "once",
"long_aliases": [],
"short_aliases": [],
"help": "Pass `--once` to the spawned supervisor (test-only)",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": true,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl run show",
"about": "Show one run's manifest and counters",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl run wait",
"about": "Block until one or more runs reach a terminal state (`done | failed | cancelled`) and emit a structured summary, so callers stop hand-rolling `run show` poll loops. Read-only: never mutates run state. Exit codes: `0` condition met, `1` usage/unknown run, `2` timeout, `3` (`--fail-on-error`) a settled run failed",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "all",
"long": "all",
"long_aliases": [],
"short_aliases": [],
"help": "Return once *every* listed run is terminal (default)",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [
"any"
],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "any",
"long": "any",
"long_aliases": [],
"short_aliases": [],
"help": "Return as soon as *one* listed run is terminal",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "fail_on_error",
"long": "fail-on-error",
"long_aliases": [],
"short_aliases": [],
"help": "Exit `3` if the condition is met but a settled run was `failed`/`cancelled` (default: exit `0` for any terminal state)",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "poll_interval",
"long": "poll-interval",
"long_aliases": [],
"short_aliases": [],
"help": "Override the internal poll cadence (default: bounded backoff, 100ms→2s). Callers shouldn't normally need this",
"value_names": [
"POLL_INTERVAL"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "progress",
"long": "progress",
"long_aliases": [],
"short_aliases": [],
"help": "Emit one JSONL line per run state-transition to stderr for live UIs",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "timeout",
"long": "timeout",
"long_aliases": [],
"short_aliases": [],
"help": "Give up after this duration (e.g. `30s`, `5m`, `1h`; a bare integer is seconds, so `2400` == `2400sec`); exit code `2` distinguishes timeout from a met condition. Defaults to `6h` — a sane ceiling so a wait on a stuck run can never block an orchestrator forever; pass a larger value for a long campaign",
"value_names": [
"TIMEOUT"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"6h"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"help": "One or more run ids to wait on",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": true,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl skill",
"about": "List, show, or install companion AI-skills shipped with this binary",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl skill install",
"about": "Copy a skill's SKILL.md to the agent's skill directory. Installs every embedded skill when no name is given (per §15)",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "agent",
"long": "agent",
"long_aliases": [],
"short_aliases": [],
"help": "Which agent runtime to install for",
"value_names": [
"AGENT"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"claude"
],
"accepted_values": [
"claude",
"codex",
"all"
],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "dest",
"long": "dest",
"long_aliases": [],
"short_aliases": [],
"help": "Override the destination path. Incompatible with `--agent all` and with the install-all (no-name) form",
"value_names": [
"DEST"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "force",
"long": "force",
"long_aliases": [],
"short_aliases": [],
"help": "Overwrite existing files at the destination(s)",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "name",
"help": "Skill name (see `skill list`). Omit to install every skill",
"value_names": [
"NAME"
],
"index": 1,
"required": false,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl skill list",
"about": "List skills embedded in this binary",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
},
{
"command": "orchestratectl skill print",
"about": "Stream a skill's SKILL.md (frontmatter + body) byte-identically to stdout. Read-only twin of `install` (AGENTS-AI-FIRST-CLI §16)",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "name",
"help": "Skill name (see `skill list`)",
"value_names": [
"NAME"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl skill show",
"about": "Print a skill's SKILL.md to stdout",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "name",
"help": "Skill name (see `skill list`)",
"value_names": [
"NAME"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl spinoff",
"about": "List, approve, or reject spin-off proposals on a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": [
{
"command": "orchestratectl spinoff approve",
"about": "Approve a proposal: emit `spinoff.approved` and (optionally) materialize an issue via `issuectl new`",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"help": "Dedupes the *local* `spinoff.approved` event-log write only. Does NOT prevent a duplicate `issuectl new` call on retry — for retry-safe materialization, pass `--issue-slug` so the `issuectl` call is skipped entirely",
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "issue_slug",
"long": "issue-slug",
"long_aliases": [],
"short_aliases": [],
"help": "Caller asserts the issue is already materialized at this slug; skips the `issuectl new` call",
"value_names": [
"ISSUE_SLUG"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "proposal_id",
"value_names": [
"PROPOSAL_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl spinoff list",
"about": "List spin-off proposals for a run",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help (see more with '--help')",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "status",
"long": "status",
"long_aliases": [],
"short_aliases": [],
"help": "Filter by status (`pending`, `approved`, `rejected`)",
"value_names": [
"STATUS"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [
"pending",
"approved",
"rejected"
],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl spinoff reject",
"about": "Reject a proposal: emit `spinoff.rejected`",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "dry_run",
"long": "dry-run",
"long_aliases": [],
"short_aliases": [],
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "idempotency_key",
"long": "idempotency-key",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"IDEMPOTENCY_KEY"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "reason",
"long": "reason",
"long_aliases": [],
"short_aliases": [],
"value_names": [
"REASON"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
},
{
"name": "proposal_id",
"value_names": [
"PROPOSAL_ID"
],
"index": 2,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
}
]
},
{
"command": "orchestratectl supervise",
"about": "Long-lived per-run supervisor: tail-follow events, watchdog agents, consume child `node.report` events with deterministic- ID dedup. Re-enters the same binary; `run reattach` invokes it",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "max_iter",
"long": "max-iter",
"long_aliases": [],
"short_aliases": [],
"help": "Tick at most this many iterations, then exit cleanly. **Test-only escape hatch — never set in production.** Note: `--once` takes precedence — when both are set the loop still exits after the first tick, regardless of `--max-iter`",
"value_names": [
"MAX_ITER"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "no_quarantine_corrupt_lines",
"long": "no-quarantine-corrupt-lines",
"long_aliases": [],
"short_aliases": [],
"help": "Opt out of corrupt-line quarantine. By default the supervisor heals a poisoned `events.jsonl` it tails over: the corrupt line is renamed aside to `events.jsonl.corrupt-<ts>.bak` and a recovered log is written in its place, then a `supervisor.event_log_quarantined` event is emitted. With this flag the corrupt line is only skipped in memory and surfaced via `supervisor.event_log_skipped_line` (the P2 behavior), leaving the poison bytes on disk for a future strict reader to trip on",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "once",
"long": "once",
"long_aliases": [],
"short_aliases": [],
"help": "Tick the watchdog + tail loops exactly once, then exit cleanly. **Test-only escape hatch — never set in production.**",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [
"false"
],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [
{
"name": "run_id",
"help": "Run id to supervise",
"value_names": [
"RUN_ID"
],
"index": 1,
"required": true,
"multiple": false,
"accepted_values": [],
"accepts_file_paths": false,
"defaults": [],
"deprecated": false
}
],
"subcommands": []
},
{
"command": "orchestratectl version",
"about": "Show binary, commit, and state-schema versions",
"aliases": [],
"hidden": false,
"deprecated": false,
"flags": [
{
"name": "help",
"long": "help",
"short": "h",
"long_aliases": [],
"short_aliases": [],
"help": "Print help",
"value_names": [],
"takes_value": false,
"multiple": false,
"required": false,
"is_global": false,
"hidden": false,
"deprecated": false,
"defaults": [],
"accepted_values": [],
"accepts_file_paths": false,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 0,
"max": 0,
"repeated": false,
"multi_value": false,
"require_equals": false
}
},
{
"name": "output",
"long": "output",
"long_aliases": [],
"short_aliases": [],
"help": "Output format. `jsonl` (default) emits one compact JSON envelope per line on stdout — AI-first. `json` emits a single pretty document. `text` emits a human-readable summary. A path-shaped value (`./out.json`, `./out.jsonl`) routes the machine envelope to that file (the format is inferred from the extension)",
"value_names": [
"FMT|PATH"
],
"takes_value": true,
"multiple": false,
"required": false,
"is_global": true,
"hidden": false,
"deprecated": false,
"defaults": [
"jsonl"
],
"accepted_values": [
"json",
"jsonl",
"text"
],
"accepts_file_paths": true,
"conflicts_with": [],
"requires": [],
"required_unless_present": [],
"arity": {
"min": 1,
"max": 1,
"repeated": false,
"multi_value": false,
"require_equals": false
}
}
],
"positionals": [],
"subcommands": []
}
]
},
"warnings": []
}