agent-inspect

<p align="center" <img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/agent-inspect-logo-mark.svg?sanitize=true" width="56" height="56" alt="AgentInspect" </p <p align="center"<strongagent-inspect</strong</p <p align="center"Local-first evidence for TypeScript AI agents</p

<h1 align="center" See what your agent did.<br Catch the wrong path in CI.<br Keep the evidence local. </h1

<p align="center" AgentInspect turns TypeScript agent runs into readable execution trees, deterministic trajectory checks, and portable Evidence v2—without requiring an account, collector, or default upload. </p

<p align="center"<strongCapture once. Debug, prevent, and share from the same local trace.</strong</p

<p align="center"<subNo account · no collector · no default upload · metadata-only by default</sub</p

<p align="center" <a href="https://agentinspect.vercel.app/"Website</a · <a href="https://agentinspect.vercel.app/docs/"Docs</a · <a href="https://www.npmjs.com/package/agent-inspect"npm</a · <a href="https://github.com/rajudandigam/agent-inspect"GitHub</a </p

<p align="center" <a href="https://www.npmjs.com/package/agent-inspect"<img src="https://img.shields.io/npm/v/agent-inspect.svg" alt="npm version"</a <a href="LICENSE"<img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license"</a <a href="package.json"<img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="Node.js 20 or newer"</a </p

Support level: Stable — see SUPPORT-LEVELS.md. Network behavior: NETWORK-BEHAVIOR.md.

npm install agent-inspect

<p align="center" <img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/showcase/gif/debug-tree.gif" alt="AgentInspect lists a local demo-good run, then you inspect the execution tree from the same JSONL" width="900" </p

Agent code rarely fails as one function call. It plans, retrieves, calls tools, invokes a model, retries, and produces side effects. Flat logs show fragments. AgentInspect keeps the run as local JSONL and gives you one evidence loop from the same trace.

<p align="center" <img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/readme-product-loop.svg?sanitize=true" alt="Capture one local trace, then debug, prevent, and share from the same evidence loop" width="900" </p

One trace. Three jobs.

Debug — read the execution path

See nested steps, tool calls, LLM calls, model and token metadata, durations, errors, and the first causal failure without sending the trace to an AgentInspect service.

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

Use manual instrumentation, official adapters, supported standards files, or structured logs you already emit.

Prevent — fail CI on the wrong trajectory