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 agentdxHomebrew: coming soon.
Dashboard screenshot coming soon. See agentdx.ai for a preview.
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 agentdxThe 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 offFull details in PRIVACY.md.
Contributing
See CONTRIBUTING.md for setup instructions, coding standards, and PR process.