Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Jul 30, 2026

Troubleshooting and command reference

Troubleshooting

SymptomFix
Pairing status reports that setup is incomplete.Run the skill again and let it complete setup, or use benchmark pair setup --agent codex in the CLI-only workflow.
benchmark update fails or still targets an old install channel.Reinstall with the public installer: curl -fsSL https://teamwork-graph.atlassian.com/cli/benchmark/install | bash.
A run was interrupted.Start a new paired run through the skill so both isolated lanes use the same selector and fresh pairing.
I need to inspect a failed command.Run benchmark <command> --help and share the exact command, exit code, stdout, and stderr.

Full command reference

These are the commands a benchmark run uses. Run benchmark <command> --help for the complete flag list on any of them.

CommandPurpose
benchmark versionConfirm the installed CLI version.
benchmark updateUpdate a healthy current installation; use the public installer if update fails.
benchmark pair status --agent codex --jsonCheck pairing readiness. Exit code 1 means setup is still required.
benchmark pair setup --agent codexConfigure and verify pairing for the selected agent.
benchmark liveStart the local dashboard for a CLI-only paired run.
benchmark run controlRun the isolated baseline lane.
benchmark run testRun the isolated Teamwork Graph lane.
benchmark doctorRun CLI diagnostics.
benchmark reportRegenerate a local report from a completed run.
benchmark report zipPackage local results when sharing has been explicitly agreed.

Pairing arguments

ArgumentRule
--orchestrator-host HOSTOptional host override for benchmark pair setup and benchmark pair status. For example, use benchmark pair setup --agent codex --orchestrator-host cursor in Cursor. Omit it for normal Codex and Claude Code runs because auto is the default.

Arguments for the two-lane commands

ArgumentRule
--agent codex / --agent claudeUse the same agent in both lanes.
--suite ccSupported default suite; pass it to both lanes.
--scenario NAMEUse instead of --suite or --prompt, and pass it to both lanes.
--prompt TEXTUse instead of --suite or --scenario, and pass the exact same text to both lanes.
--parallelism 1Keep each lane serial and predictable.
--binaryResolve the installed twg binary for the test lane only.
Selector ruleChoose exactly one of --suite, --scenario, or --prompt. Do not add unsupported --limit.

Rate this page: