{"id":51193135,"url":"https://github.com/rajudandigam/agent-inspect","last_synced_at":"2026-07-15T04:01:04.123Z","repository":{"id":355166082,"uuid":"1227043167","full_name":"rajudandigam/agent-inspect","owner":"rajudandigam","description":"Local execution trees for TypeScript AI agents.  agent-inspect helps you understand what happened inside an AI agent run — locally. It turns manual steps, tool calls, LLM calls, structured logs, failures, durations, and run metadata into readable execution trees you can inspect from the terminal.  It is built for TypeScript/Node.js developers..","archived":false,"fork":false,"pushed_at":"2026-07-09T02:52:26.000Z","size":4453,"stargazers_count":208,"open_issues_count":12,"forks_count":88,"subscribers_count":70,"default_branch":"main","last_synced_at":"2026-07-09T03:24:32.001Z","etag":null,"topics":["agent-observability","agentic-ai","ai","ai-agent","ai-debugging","ai-logging-library","ai-observability","ai-systems","braintrust","langfuse","langsmith","local-logging","logging","multi-agent","no-cloud","no-cost","observability","opentelemetry","typescript"],"latest_commit_sha":null,"homepage":"https://agentinspect.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rajudandigam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-02T06:07:29.000Z","updated_at":"2026-07-09T02:52:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rajudandigam/agent-inspect","commit_stats":null,"previous_names":["rajudandigam/agent-inspect"],"tags_count":397,"template":false,"template_full_name":null,"purl":"pkg:github/rajudandigam/agent-inspect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajudandigam%2Fagent-inspect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajudandigam%2Fagent-inspect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajudandigam%2Fagent-inspect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajudandigam%2Fagent-inspect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rajudandigam","download_url":"https://codeload.github.com/rajudandigam/agent-inspect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajudandigam%2Fagent-inspect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35489696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-observability","agentic-ai","ai","ai-agent","ai-debugging","ai-logging-library","ai-observability","ai-systems","braintrust","langfuse","langsmith","local-logging","logging","multi-agent","no-cloud","no-cost","observability","opentelemetry","typescript"],"created_at":"2026-06-27T18:00:16.712Z","updated_at":"2026-07-15T04:01:04.102Z","avatar_url":"https://github.com/rajudandigam.png","language":"TypeScript","funding_links":[],"categories":["LLMOps"],"sub_categories":["LLM Observability \u0026 Tracing"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/agent-inspect-logo-dark.svg?sanitize=true\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/agent-inspect-logo.svg?sanitize=true\" width=\"240\" alt=\"AgentInspect\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eagent-inspect\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eDebug, regression-test, and safely share TypeScript AI-agent behavior—locally.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eNo account · no default upload · metadata-only by default · optional customer-owned Studio\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  AgentInspect turns agent runs into \u003cstrong\u003ecustomer-owned evidence\u003c/strong\u003e: execution trees,\n  deterministic contracts, CI gates, verified-safe bundles, and optional self-hosted review.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://agentinspect.vercel.app/\"\u003eWebsite\u003c/a\u003e ·\n  \u003ca href=\"https://agentinspect.vercel.app/docs/\"\u003eDocs\u003c/a\u003e ·\n  \u003ca href=\"https://www.npmjs.com/package/agent-inspect\"\u003enpm\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/rajudandigam/agent-inspect\"\u003eGitHub\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/agent-inspect\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/agent-inspect.svg\" alt=\"npm version\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"MIT license\"\u003e\u003c/a\u003e\n  \u003ca href=\"package.json\"\u003e\u003cimg src=\"https://img.shields.io/badge/node-%3E%3D20-brightgreen\" alt=\"Node.js \u003e= 20\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.typescriptlang.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/TypeScript-strict-3178c6\" alt=\"TypeScript\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n```bash\nnpm install agent-inspect\n```\n\n## Three workflows\n\n| Workflow | What you do |\n| -------- | ----------- |\n| **Debug one run** | Capture/import → tree / timeline / report → first causal failure |\n| **Prevent one regression** | TraceContract / `check` → suite / cohort → CI gate |\n| **Share one safe artifact** | Redact → `verify-safe` → offline bundle → optional Studio review |\n\n**Review as a team (optional):** workspace + optional SQLite index → customer-owned [Studio Beta](https://github.com/rajudandigam/agent-inspect/tree/main/packages/studio) (no AgentInspect-hosted cloud).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg 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\"\u003e\n\u003c/p\u003e\n\n## Five-minute path\n\nCommands below match the packed quickstart. Replace `\u003crun-id\u003e` with a value from `list`.\n\n```bash\nnpm install agent-inspect\nnpx agent-inspect init --yes\nnode examples/agent-inspect-demo.mjs\nnpx agent-inspect list --dir .agent-inspect\n```\n\n```bash\n# After copying a run id from list:\nnpx agent-inspect view \u003crun-id\u003e --dir .agent-inspect\nnpx agent-inspect report \u003crun-id\u003e --dir .agent-inspect\nnpx agent-inspect check \u003crun-id\u003e --dir .agent-inspect\nnpx agent-inspect bundle \u003crun-id\u003e --dir .agent-inspect --profile share\nnpx agent-inspect verify-safe \u003crun-id\u003e --dir .agent-inspect\n```\n\n`init` scaffolds config and a demo script; the **demo** writes the trace. Guide: [First trace in 5 minutes](https://agentinspect.vercel.app/docs/getting-started/) · [repo](https://github.com/rajudandigam/agent-inspect/blob/main/docs/FIRST-TRACE-IN-5-MINUTES.md) · [Golden path](https://github.com/rajudandigam/agent-inspect/blob/main/docs/GOLDEN-PATH.md)\n\n## Choose your capture path\n\n| Path | Use when | Start |\n| ---- | -------- | ----- |\n| **Manual / observe** | Custom nesting or object methods | [Getting started](https://github.com/rajudandigam/agent-inspect/blob/main/docs/GETTING-STARTED.md) |\n| **AI SDK** | Vercel AI SDK `generateText` / `streamText` | [`@agent-inspect/ai-sdk`](https://www.npmjs.com/package/@agent-inspect/ai-sdk) |\n| **OpenAI Agents** | OpenAI Agents JS | [`@agent-inspect/openai-agents`](https://www.npmjs.com/package/@agent-inspect/openai-agents) |\n| **LangChain** | Callbacks / LangGraph-via-LangChain | [`@agent-inspect/langchain`](https://www.npmjs.com/package/@agent-inspect/langchain) |\n| **Structured logs** | Logs already emitted | [Log-to-tree](https://github.com/rajudandigam/agent-inspect/blob/main/docs/LOG-TO-TREE-QUICKSTART.md) |\n| **Harness** | Fixture runner for real projects | [`@agent-inspect/harness`](https://www.npmjs.com/package/@agent-inspect/harness) |\n| **CI reporters** | Failed-test artifacts | [`vitest`](https://www.npmjs.com/package/@agent-inspect/vitest) · [`jest`](https://www.npmjs.com/package/@agent-inspect/jest) |\n| **Standards files** | OpenInference / OTLP JSON | [Standards](https://github.com/rajudandigam/agent-inspect/blob/main/docs/STANDARDS.md) |\n\nBlessed starters (no API keys): [examples/starters](https://github.com/rajudandigam/agent-inspect/tree/main/examples/starters)\n\n## What you can do after capture\n\n**Understand** — `what` / `view` / tree · timeline · report · diff · sessions / activity  \n\n**Prevent regressions** — deterministic checks · typed TraceContract (Beta) · suites · cohorts · CI gates · Vitest/Jest reporters (artifact reporters today; TraceContract matchers not shipped)  \n\n**Share safely** — redaction profiles · `scan` · `verify-safe` · offline bundles · CI artifacts  \n\n**Scale locally** — workspace · optional SQLite index (Beta) · observed outcomes · viewer / TUI / VS Code  \n\n**Review as a team** — customer-owned Studio Beta · explicit file / GitHub / HTTP ingest (disabled by default) · no maintainer cloud  \n\n**Interoperate** — read-only MCP server (Preview) · OpenInference-compatible / OTLP GenAI-aligned mapping with known-loss reporting  \n\nSupport labels: [SUPPORT-LEVELS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md) · Network: [NETWORK-BEHAVIOR.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NETWORK-BEHAVIOR.md)\n\n## Real-world scenarios\n\n| Scenario | Start |\n| -------- | ----- |\n| Wrong tool call | [broken-agent starter](https://github.com/rajudandigam/agent-inspect/tree/main/examples/starters/broken-agent-debugging) |\n| CI trajectory gate | [CI artifacts](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CI-ARTIFACTS.md) |\n| Safe incident handoff | [Safe sharing](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SAFE-TRACE-SHARING.md) |\n| Multi-agent / session retry | [Sessions \u0026 outcomes](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SESSIONS-AND-OUTCOMES.md) |\n| Customer-owned team review | [Self-hosting](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SELF-HOSTING.md) · Studio |\n| Design partner trial | [Pilot kit](https://github.com/rajudandigam/agent-inspect/blob/main/docs/PRE-V7-PILOT-KIT.md) |\n\n## Safety and network behavior\n\n- Traces are **local JSONL** under `.agent-inspect/` (or `AGENT_INSPECT_TRACE_DIR`)\n- **Metadata-only by default** — no raw prompts/outputs unless you opt in\n- **No hidden upload** — core does not send traces to AgentInspect\n- **Customer-owned Studio ingestion** is disabled by default and explicit when enabled\n- **MCP server** exposes configured local evidence to the connected client (Preview)\n- **Standards export** only when you run/configure it\n- Redaction is **best-effort**, not certification — review before posting\n- **Not** a chain-of-thought recorder\n\nDetails: [Safe sharing](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SAFE-TRACE-SHARING.md) · [Network behavior](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NETWORK-BEHAVIOR.md) · [Security](SECURITY.md)\n\n## Project status\n\n**Current release:** **6.7.3** (eighteen linked npm packages). Technical launch candidate; external pilot evidence pending. Persisted schema **1.0**. Node.js **≥ 20**. **v7 not scheduled.**\n\n[Roadmap](ROADMAP.md) · [Pilot kit](https://github.com/rajudandigam/agent-inspect/blob/main/docs/PRE-V7-PILOT-KIT.md) · [Changelog](CHANGELOG.md)\n\n## What AgentInspect is not\n\n- Hosted SaaS or maintainer-hosted dashboard\n- Production APM replacement\n- Eval dataset platform or LLM-as-judge by default\n- Prompt registry, pricing engine, or replay engine\n- Universal standards exporter or completed external adoption proof\n\nSee [Compare](https://github.com/rajudandigam/agent-inspect/blob/main/docs/COMPARE.md).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePackage family (18 public packages)\u003c/strong\u003e\u003c/summary\u003e\n\n### Framework adapters\n\n| Package | Purpose |\n| ------- | ------- |\n| [`agent-inspect`](https://www.npmjs.com/package/agent-inspect) | Core APIs + CLI |\n| [`@agent-inspect/ai-sdk`](https://www.npmjs.com/package/@agent-inspect/ai-sdk) | AI SDK telemetry |\n| [`@agent-inspect/openai-agents`](https://www.npmjs.com/package/@agent-inspect/openai-agents) | OpenAI Agents processor |\n| [`@agent-inspect/langchain`](https://www.npmjs.com/package/@agent-inspect/langchain) | LangChain callbacks |\n\n### Testing / evaluation\n\n| Package | Purpose |\n| ------- | ------- |\n| [`@agent-inspect/harness`](https://www.npmjs.com/package/@agent-inspect/harness) | Fixture runner |\n| [`@agent-inspect/eval`](https://www.npmjs.com/package/@agent-inspect/eval) | Local eval heuristics |\n| [`@agent-inspect/vitest`](https://www.npmjs.com/package/@agent-inspect/vitest) | Vitest reporter |\n| [`@agent-inspect/jest`](https://www.npmjs.com/package/@agent-inspect/jest) | Jest reporter |\n\n### Safety\n\n| Package | Purpose |\n| ------- | ------- |\n| [`@agent-inspect/redact`](https://www.npmjs.com/package/@agent-inspect/redact) | Deterministic redaction |\n| [`@agent-inspect/guardrails`](https://www.npmjs.com/package/@agent-inspect/guardrails) | Deterministic guardrail rules |\n| [`@agent-inspect/circuit`](https://www.npmjs.com/package/@agent-inspect/circuit) | Loop / retry / timeout analyzers |\n\n### Developer surfaces\n\n| Package | Purpose |\n| ------- | ------- |\n| [`@agent-inspect/viewer`](https://www.npmjs.com/package/@agent-inspect/viewer) | Localhost viewer |\n| [`@agent-inspect/tui`](https://www.npmjs.com/package/@agent-inspect/tui) | Optional terminal UI |\n| [`@agent-inspect/mcp`](https://www.npmjs.com/package/@agent-inspect/mcp) | MCP client tracing |\n| [`@agent-inspect/mcp-server`](https://www.npmjs.com/package/@agent-inspect/mcp-server) | Read-only MCP server (Preview) |\n\n### Team / self-hosted\n\n| Package | Purpose |\n| ------- | ------- |\n| [`@agent-inspect/index-sqlite`](https://www.npmjs.com/package/@agent-inspect/index-sqlite) | Optional SQLite index (Beta) |\n| [`@agent-inspect/studio`](https://www.npmjs.com/package/@agent-inspect/studio) | Customer-owned Studio (Beta) |\n\n### Extension / interop\n\n| Package | Purpose |\n| ------- | ------- |\n| [`@agent-inspect/adapter-sdk`](https://www.npmjs.com/package/@agent-inspect/adapter-sdk) | Third-party adapters (Beta) |\n\n`agent-inspect-vscode` is in-repo (Marketplace not published yet).\n\n\u003c/details\u003e\n\n## Documentation\n\n| | Website | Repo |\n| - | ------- | ---- |\n| Getting started | [docs](https://agentinspect.vercel.app/docs/getting-started/) | [FIRST-TRACE](https://github.com/rajudandigam/agent-inspect/blob/main/docs/FIRST-TRACE-IN-5-MINUTES.md) |\n| Contracts / suites / gates | — | [TRACE-CONTRACTS](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-CONTRACTS.md) · [SUITES-COHORTS-GATES](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUITES-COHORTS-GATES.md) |\n| Safe sharing | [safe-sharing](https://agentinspect.vercel.app/docs/safe-sharing/) | [SAFE-TRACE-SHARING](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SAFE-TRACE-SHARING.md) |\n| API / CLI | — | [API](docs/API.md) · [CLI](docs/CLI.md) (packed with npm) |\n| Full index | — | [docs/README.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/README.md) |\n\n## Contributing\n\n[CONTRIBUTING.md](https://github.com/rajudandigam/agent-inspect/blob/main/CONTRIBUTING.md) · [Good first issues](https://github.com/rajudandigam/agent-inspect/blob/main/GOOD-FIRST-ISSUES.md) · [Discussions](https://github.com/rajudandigam/agent-inspect/discussions)\n\n**Redact traces before posting issues or PRs.**\n\n```bash\npnpm add agent-inspect\nnpx agent-inspect doctor\n```\n\nMonorepo: `pnpm install \u0026\u0026 pnpm build \u0026\u0026 pnpm test`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajudandigam%2Fagent-inspect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frajudandigam%2Fagent-inspect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajudandigam%2Fagent-inspect/lists"}