First trace in 5 minutes

Install AgentInspect, run the keyless demo, inspect a trace, check trajectory, and verify a share-safe Evidence bundle.

Goal: install → one trace → one trajectory check → one share-safe Evidence bundle.

Docs site: https://agentinspect.vercel.app/docs/getting-started/

npm install agent-inspect
npx agent-inspect init --yes
node examples/agent-inspect-demo.mjs
npx agent-inspect list --dir .agent-inspect

Copy a <run-id> from list, then:

npx agent-inspect view <run-id> --dir .agent-inspect --summary
npx agent-inspect check <run-id> --dir .agent-inspect --preset trajectory
npx agent-inspect verify-safe <run-id> --dir .agent-inspect
npx agent-inspect bundle <run-id> --dir .agent-inspect --profile share --out ./evidence
npx agent-inspect bundle verify ./evidence

init scaffolds files into the current directory (agent-inspect.config.ts, .agent-inspect/, and examples/agent-inspect-demo.mjs). It does not install dependencies or write a trace by itself. Use --preset trajectory for structural CI gates; --fail-on-observation belongs only in examples that record explicit OUTCOME events.

Minutes 0–1: Install

mkdir my-agent-debug && cd my-agent-debug
npm install agent-inspect
npx agent-inspect init --yes

Framework users: pick the correct capture path first — CHOOSE-YOUR-CAPTURE-PATH.md.

Minutes 1–2: Run

node examples/agent-inspect-demo.mjs

No API keys. Deterministic local trace under .agent-inspect/.

Minutes 2–3: Inspect

npx agent-inspect list --dir .agent-inspect
npx agent-inspect view <run-id> --dir .agent-inspect --summary

Replace <run-id> with the ID printed by list (do not guess “latest file”).

Minutes 3–4: Check

npx agent-inspect check <run-id> --dir .agent-inspect --preset trajectory

Expected exit code 0 for the keyless demo. Add --required-tool <name> only when that tool is part of the real expected workflow.

Minutes 4–5: Share-safe artifact

npx agent-inspect verify-safe <run-id> --dir .agent-inspect
npx agent-inspect bundle <run-id> --dir .agent-inspect --profile share --out ./evidence
npx agent-inspect bundle verify ./evidence

--out ./evidence writes the Evidence v2 package to a known path; bundle verify ./evidence checks that exact directory. Do not use --allow-unsafe to force a share.

Optional file redaction before bundling:

npx agent-inspect redact <run-id> --dir .agent-inspect --profile share -o redacted.jsonl

Next steps

Full index: docs/README.md · Website docs: agentinspect.vercel.app/docs