Skip to content

v0.7.0: scan, a dry run on your own coding agent's history

Choose a tag to compare

@ntinosgkiou-code ntinosgkiou-code released this 25 Oct 20:16
· 15 commits to main since this release

scan: a dry run on your own coding agent's history.

git clone https://github.com/ntinosgkiou-code/agentdryrun && cd agentdryrun && python -m agentdryrun scan

It reads the Claude Code transcripts on your machine (~/.claude/projects, last 30 days), names what the agent attempted, judges each action against a starter rules pack, and writes one HTML report card: what would pass, what would need approval, what would be refused, and where the tool output piled up. Read-only, local, nothing is sent anywhere. Use --no-previews before you share the page.

  • Starter rules: agentdryrun/packs/coding-agent.json (copy it, edit it, pass --rules). --events-out writes the derived events for shadow; --max-refused / --max-pending exit 4 for CI.
  • Tuned on a real 90-day history to remove false alarms (here-documents, quoted text, cd and variables set earlier in the command, curl | python -c, filtered find -delete). Invented sample: python -m agentdryrun scan --root examples/claude-code-sample/projects --days 0; sample report card.
  • 114 tests. CI green on Python 3.9/3.11/3.12 and Node 18/22.

What it is not: pattern matching on commands, so it misses scripts and run-time paths and flags a few harmless things; it cannot know whether a command worked or whether you approved it; Claude Code only (the transcript format is not a documented interface and was read as it looked on 2026-10-25); not a sandbox, a certification or a security audit. Prototype, no external review.