Example Workflow

Start in a Git repository:

agenttrace init

Begin auditing an AI coding session:

agenttrace start "add CSV export to billing report" --tool Codex --model gpt-5

Run the AI coding tool and make the code changes. Then capture the repository evidence:

agenttrace snapshot

Record test evidence:

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

Create review notes in a local file:

# Review Notes

- Checked CSV escaping.
- Confirmed tests cover empty reports.
- Residual risk: large exports are not performance tested.

Append the review:

agenttrace add-review review-notes.md

Generate the report:

agenttrace report

The generated report.md includes the task, run id, timestamps, git metadata, changed files, test evidence, review evidence, risk notes, and final checklist.