agent-inspect

Name: agent-inspect
Author: rajudandigam

Pending

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..

108stars

83forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/rajudandigam/agent-inspect

Getting Started

Guides for using ai agents skills like agent-inspect.

README.md

Frequently Asked Questions

What is agent-inspect?

agent-inspect is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by rajudandigam. 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. It has 108 GitHub stars.

Is agent-inspect safe to use?

agent-inspect's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install agent-inspect?

Clone the repository with "git clone https://github.com/rajudandigam/agent-inspect" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is agent-inspect written in?

agent-inspect is primarily written in TypeScript. It is open-source under rajudandigam on GitHub, so you can review or fork the full source.

Are there alternatives to agent-inspect?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agent-inspect against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

GenAI-AgenticAI-From-Zero-to-Production agent-watch-approve

agent-inspect

Local-first TypeScript toolkit: trace what happened, check what should have happened, redact what must not leave your machine.

No account · no upload · no hosted dashboard · metadata-only by default

npm install agent-inspect

60-second quickstart

npx agent-inspect init --yes
node examples/agent-inspect-demo.mjs
npx agent-inspect list --dir .agent-inspect
npx agent-inspect view <run-id> --dir .agent-inspect
npx agent-inspect report <run-id> --dir .agent-inspect
npx agent-inspect verify-safe --dir .agent-inspect

North star: install → one trace → one failure check → one share-safe artifact in under five minutes. See First trace in 5 minutes.

Choose your path

Path	When	Start here
AI SDK	Vercel AI SDK `generateText` / `streamText`	`@agent-inspect/ai-sdk` · guide
OpenAI Agents	OpenAI Agents JS local tracing	`@agent-inspect/openai-agents` · guide
LangChain	Callback adapter, LangGraph-via-LangChain	`@agent-inspect/langchain`
Observe	Existing class with `run` / `execute`	Getting started § observe
Manual	Custom control flow	`inspectRun` + `step` in API
Logs	Structured logs already emitted	Log-to-tree
CI / tests	Failed test artifacts	`@agent-inspect/vitest` · `@agent-inspect/jest`
Real projects	Fixture harness	`@agent-inspect/harness`

Blessed starters (no API keys): examples/starters

What it helps with

Wrong tool call — see tool steps, args metadata, and parent run in the tree
Baseline vs candidate — diff two runs locally
Eval / test failures — check, eval, Vitest/Jest reporters
PR artifacts — CI artifacts + redact --profile share
Multi-agent / sessions — sessions, search, handoff metadata
MCP tools — @agent-inspect/mcp client tracing
VS Code — in-repo extension (packages/vscode); dev guide — Marketplace listing manual

Real-world scenarios

Scenario	Doc
Local debugging	USE-CASES.md
CI failure review	USE-CASES.md § CI trace artifact
Team adoption	TEAM-WORKFLOWS.md · Design partners

Package map

Package	Purpose
`agent-inspect`	Core + CLI
`@agent-inspect/ai-sdk`	AI SDK telemetry
`@agent-inspect/openai-agents`	OpenAI Agents processor
`@agent-inspect/langchain`	LangChain callbacks
`@agent-inspect/harness`	Fixture runner for real projects
`@agent-inspect/redact`	Deterministic redaction
`@agent-inspect/eval`	Local eval heuristics
`@agent-inspect/vitest`	Vitest reporter
`@agent-inspect/jest`	Jest reporter
`@agent-inspect/mcp`	MCP client tracing
`@agent-inspect/mcp-server`	Read-only trace MCP server
`@agent-inspect/guardrails`	Deterministic guardrail rules
`@agent-inspect/circuit`	Loop/retry/timeout analyzers
`@agent-inspect/viewer`	Localhost viewer
`@agent-inspect/adapter-sdk`	Third-party adapters
`@agent-inspect/tui`	Optional terminal UI
`agent-inspect-vscode`	VS Code extension (in-repo, not on Marketplace yet)

Safety model

Traces are local JSONL files under .agent-inspect/ (or AGENT_INSPECT_TRACE_DIR)
Metadata-only by default — no raw prompts/outputs unless you opt in
No hidden upload — AgentInspect does not send traces to the cloud
Redaction profiles — local / share / strict via @agent-inspect/redact or CLI
scan / verify-safe — check artifacts before sharing
Not a chain-of-thought recorder or compliance engine

Details: Safe trace sharing · Security

Documentation

Start	Reference	Adoption
Getting started	API	Adoption
First trace in 5 min	CLI	Demo script
Use cases	Adapters	Technical guide
Examples	Performance	Pitch

Full index: docs/README.md · Visual demos: SCREENSHOTS.md

What AgentInspect is not

Hosted SaaS or dashboard product
Production APM replacement (use LangSmith, Langfuse, OTel, etc. alongside)
Eval dataset platform or LLM-as-judge service
Prompt registry or pricing engine
Default telemetry uploader or replay engine

Install details

Current release: 3.5.3 (sixteen linked npm packages). Persisted trace schema 1.0.

pnpm add agent-inspect
npx agent-inspect doctor

Monorepo development: pnpm install && pnpm build && pnpm test

Contributing

CONTRIBUTING.md · Good first issues · Discussions · Changelog

Redact traces before posting issues or PRs.