usage: cox runs [-h]
{usage,trace,clean,land,series,events,top,notify,detail} ...
What a harness run recorded, and cleaning up after it.
positional arguments:
{usage,trace,clean,land,series,events,top,notify,detail}
usage usage stats and cost for one run
trace the tool-call trace for one run
clean delete a run's worktree and branches locally
land merge a run's branch into the target repo
series per-run summary rows across a runs directory
events poll a run's log for structured events
top live table of runs in flight; --once prints it and
exits
notify desktop notifications for exits, quarantines, budget
stops and cost
detail one run's timeline, objection and last tool calls
options:
-h, --help show this help message and exit
examples:
cox runs land <run> --repo PATH --apply
cox runs usage <run> --json
cox runs detail <run> --json
usage
usage: cox runs usage [-h] [--runs-dir RUNS_DIR] [--json] run_id
positional arguments:
run_id
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--json
trace
usage: cox runs trace [-h] [--runs-dir RUNS_DIR] [--role ROLE] [-v] run_id
positional arguments:
run_id
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--role ROLE
-v, --verbose
clean
usage: cox runs clean [-h] --repo REPO [--worktree-root WORKTREE_ROOT]
[--apply]
run_id
positional arguments:
run_id
options:
-h, --help show this help message and exit
--repo REPO
--worktree-root WORKTREE_ROOT
--apply
land
usage: cox runs land [-h] --repo REPO [--task TASK] [--label LABEL] [--force]
[--worktree-root WORKTREE_ROOT] [--apply] [--no-merge]
run_id
positional arguments:
run_id
options:
-h, --help show this help message and exit
--repo REPO
--task TASK
--label LABEL
--force land despite a foreign live leader
--worktree-root WORKTREE_ROOT
--apply
--no-merge
series
usage: cox runs series [-h] [--runs-dir RUNS_DIR] [--json] [--append APPEND]
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--json
--append APPEND
events
usage: cox runs events [-h] [--runs-dir RUNS_DIR] [--follow] [--json]
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--follow
--json
top
usage: cox runs top [-h] [--runs-dir RUNS_DIR] [--interval INTERVAL] [--once]
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--interval INTERVAL
--once
notify
usage: cox runs notify [-h] [--runs-dir RUNS_DIR] [--once]
[--interval INTERVAL]
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--once
--interval INTERVAL
detail
usage: cox runs detail [-h] [--runs-dir RUNS_DIR] [--json] run_id
positional arguments:
run_id
options:
-h, --help show this help message and exit
--runs-dir RUNS_DIR
--json