Command Cheat Sheet¶

This page lists the common AgentTrace commands.

Show Help¶

agenttrace --help

agenttrace init

Use this once in a Git project.

agenttrace start "task description"

With tool and model:

agenttrace start "task description" --tool Codex --model gpt-5

agenttrace snapshot

This records Git status and Git diff for the active run.

agenttrace add-test "test command here"

Examples:

agenttrace add-test "npm test"

agenttrace add-test "python -m unittest discover -s tests"

agenttrace add-test "manual QA" --no-execute --note "Checked the feature in the browser."

agenttrace add-review review-notes.md

With a PR number:

agenttrace pr 42

With more details:

agenttrace pr 42 --title "Add validation" --base main --head feature/validation

With a full URL:

agenttrace pr https://github.com/acme/widgets/pull/42

agenttrace eval benchmark-123 --score 91.5 --regression passed --note "No regression."

agenttrace policy

Require review notes:

agenttrace policy --require-reviews

Require a clean latest snapshot:

agenttrace policy --require-clean-snapshot

Allow failed tests in the policy result:

agenttrace policy --allow-failed-tests

agenttrace report

agenttrace dashboard