agent-inspect

<p align="center" <picture <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/agent-inspect-logo-dark.svg?sanitize=true" <img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/agent-inspect-logo.svg?sanitize=true" width="240" alt="AgentInspect" </picture </p

<h1 align="center"agent-inspect</h1

<p align="center" <strongDebug, regression-test, and safely share TypeScript AI-agent behavior—locally.</strong </p

<p align="center" <subNo account · no default upload · metadata-only by default · optional customer-owned Studio</sub </p

<p align="center" AgentInspect turns agent runs into <strongcustomer-owned evidence</strong: execution trees, deterministic contracts, CI gates, verified-safe bundles, and optional self-hosted review. </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"</a <a href="https://www.typescriptlang.org/"<img src="https://img.shields.io/badge/TypeScript-strict-3178c6" alt="TypeScript"</a </p

npm install agent-inspect

Three workflows

| Workflow | What you do | | -------- | ----------- | | Debug one run | Capture/import → tree / timeline / report → first causal failure | | Prevent one regression | TraceContract / check → suite / cohort → CI gate | | Share one safe artifact | Redact → verify-safe → offline bundle → optional Studio review |

Review as a team (optional): workspace + optional SQLite index → customer-owned Studio Beta (no AgentInspect-hosted cloud).

<p align="center" <img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/readme-product-loop.svg?sanitize=true" alt="Capture or import → understand → enforce → verify and bundle → review locally or in customer-owned Studio" width="900" </p

Five-minute path

Commands below match the packed quickstart. Replace <run-id with a value from list.

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

# After copying a run id from list:
npx agent-inspect view <run-id> --dir .agent-inspect
npx agent-inspect report <run-id> --dir .agent-inspect
npx agent-inspect check <run-id> --dir .agent-inspect
npx agent-inspect bundle <run-id> --dir .agent-inspect --profile share
npx agent-inspect verify-safe <run-id> --dir .agent-inspect

init scaffolds config and a demo script; the demo writes the trace. Guide: First trace in 5 minutes · repo · Golden path

Choose your capture path