Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@agentdx/agentdx) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AgentDX

The developer experience layer for AI coding agents.

Install

npx agentdx

Homebrew: coming soon.

Screenshots

One npx agentdx and the dashboard opens on your own machine — no account, no upload.

Overview — the flight recorder at a glance

AgentDX overview dashboard

Insights — judgements, not just numbers ("which agent actually ships?")

AgentDX insights page

Models & Tokens — spend, cache hit rate, input vs output

AgentDX models and tokens page

Sessions — every coding-agent session, searchable and drillable

AgentDX sessions page

What It Does

AgentDX is a free, open-source, local-first flight recorder for AI coding agents. It reads the local logs your agents already write, stores everything in a single SQLite database, and serves a Next.js dashboard so you can see tokens burned, tools called, models used, and errors hit across every agent. One command, no accounts, your data stays on your machine.

Supported Agents

Agent	Source	Status
Claude Code	`~/.claude/projects/`	Stable
Cursor	`~/.cursor/projects/`	Stable
Codex	`~/.codex/`	Stable
Aider	Local chat history files	Stable
Cline	VS Code extension storage	Stable

AgentDX reads local logs and artifacts. It never intercepts live traffic or modifies agent behavior.

Quick Start

# 1. Collect session data from all installed agents
npx agentdx collect

# 2. Start the dashboard
npx agentdx serve

# Or do both in one command
npx agentdx

The dashboard opens at http://localhost:3002.

CLI Commands

Command	Description
`npx agentdx`	Collect data from all agents, then start the dashboard
`npx agentdx collect`	Collect session data only (no dashboard)
`npx agentdx serve`	Start the dashboard only (no collection)
`npx agentdx watch`	Collect, serve, and re-collect on an interval (default: 5 min)
`npx agentdx status`	Show database stats: sessions, messages, tool calls, tokens, models
`npx agentdx telemetry`	Show current telemetry status and what is collected
`npx agentdx telemetry off`	Disable anonymous telemetry
`npx agentdx telemetry on`	Enable anonymous telemetry
`npx agentdx org join <code>`	Join an organization with an invite code
`npx agentdx org leave`	Leave the current organization
`npx agentdx org status`	Show current organization membership

For Teams

AgentDX supports organizations for teams that want shared visibility into agent usage. Join with an invite code from your admin, or visit agentdx.ai to learn more.

Privacy

All data stays on your machine by default. AgentDX collects optional anonymous telemetry (aggregate counts only, no code or prompts) that you can disable at any time:

npx agentdx telemetry off

Full details in PRIVACY.md.

Contributing

See CONTRIBUTING.md for setup instructions, coding standards, and PR process.

License

MIT

Website | GitHub | npm | Privacy