agent-insights

CLI for AI coding agent lifecycle observability. Installs hooks into Claude Code and Cursor, uploads session transcripts to Vercel Blob, and (optionally) hands them off to an Ash analyzer that posts a digest to Slack and produces pre-filled GitHub issue URLs.

Internal tool from vercel-labs/agent-insights. See SPEC.md for the full design.

Install

npm i -g agent-insights
# or
pnpm add -g agent-insights

Quick start

agent-insights init                # writes config + installs Claude/Cursor hooks
agent-insights status              # shows config, consent, adapter state
agent-insights doctor              # validates config, Blob, hooks

init writes ~/.agent-insights/config.json and installs hook entries into the current repo's .claude/settings.json and .cursor/hooks.json.

Commands

| Command | Purpose | |---------|---------| | agent-insights init | Write config + install Claude Code/Cursor hooks | | agent-insights status | Show config, consent, and adapter state | | agent-insights doctor | Validate config, Blob, hooks | | agent-insights disable [--agent X] [--purge] | Remove hooks and/or wipe state | | agent-insights hook <event> | Invoked by agent hook configs (stdin = JSON) | | agent-insights cursor [path] | Launch Cursor with session start/end |

Environment

| Variable | Purpose | |----------|---------| | BLOB_READ_WRITE_TOKEN | Required for transcript upload (from vercel env pull) | | AGENT_INSIGHTS_ANALYZER_URL | Optional Phase 2 analyzer endpoint | | AGENT_INSIGHTS_INGEST_SECRET | Optional shared secret sent to analyzer | | AGENT_INSIGHTS_DEBUG=1 | Verbose debug to stderr | | AGENT_INSIGHTS_HOME | Override config root (default ~/.agent-insights) | | AGENT_INSIGHTS_OTEL_ENDPOINT | Phase 3 OTLP endpoint |

Develop locally

git clone https://github.com/vercel-labs/agent-insights.git
cd agent-insights
pnpm install
pnpm --filter agent-insights build
node packages/cli/dist/cli.js --help

License

Apache-2.0.