agent-inspect
Local-first toolkit to inspect TypeScript agent runs, check trajectories in CI, and share offline evidence.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
node>=20
global install agent-inspect via npm
npm install -g agent-inspectlocal npm install so demo import resolves
npm init -y 2>&1 && npm install agent-inspect
Where the README and reality differ
- README: npm install agent-inspect then npx agent-inspect init --yes then node examples/agent-inspect-demo.mjs
What worked: ran npm init -y && npm install agent-inspect locally before node examples/agent-inspect-demo.mjs; global install alone leaves Cannot find package 'agent-inspect' (init prints No dependencies were installed)
Check that it works
agent-inspect --version 2>&1The output should contain “6.31.30”.
First thing to try
agent-inspect init --yes && node examples/agent-inspect-demo.mjs && agent-inspect list --dir .agent-inspectf=(.agent-inspect/run_*.jsonl); RUN=${f[0]##*/}; RUN=${RUN%.jsonl}; echo "RUN=$RUN" && agent-inspect view "$RUN" --dir .agent-inspect --summaryRun agent-inspect init --yes in your project, then agent-inspect list --dir .agent-inspect to see recorded runs.
What it does
- Run repeatable trajectory checks in CITested
How to use it
- Find the run ID with
agent-inspect list --dir .agent-inspect. - Run
agent-inspect check <run-id> --dir .agent-inspect --preset trajectory. - Look for
Trajectory: PASSin the output.
- Find the run ID with
- Create offline evidence bundles you can shareTested
How to use it
- Run
agent-inspect bundle <run-id> --dir .agent-inspect --profile share --out <folder>. - Verify the bundle with
agent-inspect bundle verify <folder>.
- Run
- Inspect agent execution trees on your machineNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 2 of 3 features work
- Works offline
Good for
- read the execution path of a local agent run
- fail CI on the wrong agent trajectory
- create reviewable offline evidence bundle
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 6.31.30