Claude Code Agent Monitor Agent Skill

Agent Dashboard for Claude Code, Cursor & Codex

A local-first control room for AI coding agents

Monitor Claude Code, Cursor, and Codex sessions in real time. Follow conversations and tools, inspect agent hierarchies, understand token usage and cost, analyze orchestration, and operate local agents from one responsive dashboard.

[!TIP] Complete guides: English · 中文 · Tiếng Việt · 한국어 · Español

<p align="center"> <a href="images/analytics.png"><img src="images/readme/analytics.png" alt="CCAM dashboard with live agent and session activity" width="100%"></a> <br> <em>Live fleet state, active work, recent events, cost, and system health.</em> </p>

See what your agents are doing

CCAM combines native hooks with provider-aware transcript discovery. It stays local by default and turns agent activity into a searchable, durable operational record.

• One live fleet: Claude Code, Cursor, and Codex sessions appear in the same Dashboard, Sessions, Activity Feed, and Kanban views.
• Complete conversations: Rendered Markdown, highlighted code, tool calls, command output, queued prompts, attachments, and provider-native titles; Cursor adopts a generated title only when ingestion metadata proves the current fallback is CCAM-owned.
• Agent orchestration: Parent-child trees, background agents, dynamic workflow runs, tool-flow graphs, concurrency, delegation, and compaction analysis.
• Cost and usage: API-equivalent estimate details live behind the cost label's info icon; Cursor usage is counted once per generation against the concrete native model.
• Run and resume agents: Launch Claude Code or Codex, stream output, send follow-ups, resume previous work, and reattach to background runs.
• Configuration visibility: Inspect Claude Code and Codex settings, skills, hooks, MCP servers, rules, plugins, memory, profiles, and instructions.
• Operational safety: Loopback binding, optional authentication, guarded mutations, backup-first edits, bounded uploads, and no automatic self-update.
• Team-ready delivery: Desktop applications, containers, Kubernetes, Terraform, monitoring, alerts, webhooks, and remote data sources.

See CCAM in action

<p align="center"> <a href="images/session-conversation.png"><img src="images/readme/session-conversation.png" alt="Rendered agent conversation with code and tool activity" width="100%"></a> <br> <em>Conversation history with code, tools, reasoning, and session context.</em> </p> <p align="center"> <a href="images/workflows.png"><img src="images/readme/workflows.png" alt="Workflow and orchestration analytics" width="100%"></a> <br> <em>Workflow intelligence for orchestration, delegation, tools, errors, and concurrency.</em> </p> <p align="center"> <a href="images/config.png"><img src="images/readme/config.png" alt="Claude Code and Codex configuration explorers" width="100%"></a> <br> <em>Provider-aware configuration, skills, hooks, plugins, MCP, rules, and memory.</em> </p> <p align="center"> <a href="images/run.png"><img src="images/readme/run.png" alt="Run Agent provider selection" width="100%"></a> <br> <em>Launch and manage Claude Code or Codex without leaving the dashboard.</em> </p>

Quick start

Requirements: Node.js 22.22 or newer and npm 9 or newer.

git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git
cd Claude-Code-Agent-Monitor
npm run setup
npm run dev

Open http://localhost:5173. npm run setup installs the root, client, and VS Code extension dependencies, builds the MCP server, and links the ccam CLI. On first launch, follow the dashboard prompt to install hooks for the providers you select, or run npm run install-hooks manually.

For production, run npm run build && npm start and open http://localhost:4820.

Before an upgrade that may recount usage, capture and compare read-only cost snapshots:

node scripts/cost-snapshot.js snapshot --out before.tsv
# Upgrade and restart CCAM, then let startup maintenance finish.
node scripts/cost-snapshot.js snapshot --out after.tsv
node scripts/cost-snapshot.js compare before.tsv after.tsv --fail-on-local-change

Keep these TSV files private because they contain session identifiers and ownership metadata. The guard fails when an existing local session's usage or cost changes, ownership moves to or from local, or a local session disappears; remote and newly added sessions are reported separately. See the complete upgrade safeguard for the exact compared fields.

Choose how to run CCAM

Option	Best for	Guide
Source checkout	Development and local customization	Full setup guide
Desktop app	A persistent macOS or Windows app with tray controls	Desktop guide
Docker or Podman	Isolated local or server deployments	Deployment guide
Kubernetes or Terraform	Production infrastructure	Deployment reference
MCP sidecar	Agent-driven dashboard queries and guarded operations	MCP guide

Extensions and automation

CCAM ships 14 plugins, 66 plugin skills, 18 Claude subagents, 34 Claude commands, and 77 total repository skills across Claude Code and Codex formats.

claude plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
codex plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
npx skills add hoangsonww/Claude-Code-Agent-Monitor --list

The ccam CLI and local MCP server expose sessions, agents, events, transcripts, analytics, pricing, workflows, alerts, imports, configuration, remote sources, and maintenance operations for humans and automation.

Documentation

• Complete product and operational reference: README-EN.md
• Documentation index: docs/README.md
• Task-oriented handbook: GitHub Wiki
• Localized product tour: Static Wiki
• Architecture: ARCHITECTURE.md
• CLI: docs/CLI.md
• REST and OpenAPI: docs/API.md
• Hooks and lifecycle: docs/HOOKS.md
• Database: docs/DATABASE.md
• Plugins: docs/PLUGINS.md
• MCP: docs/MCP.md and mcp/README.md
• Desktop application: DESKTOP.md and desktop/README.md
• Deployment: DEPLOYMENT.md and docs/DEPLOYMENT.md
• Security: .github/SECURITY.md

Local-first and secure by default

The dashboard binds to 127.0.0.1 by default. It does not require cloud credentials, and it does not transmit your transcripts or agent data to a hosted service. Optional tokens protect HTTP, WebSocket, hook, MCP, and remote-push surfaces when you deliberately expose them beyond loopback.

See the security policy and full configuration reference before enabling remote access.

Contributing and support

• Read the contributing guide.
• Report bugs through GitHub Issues.
• Ask questions and share ideas in GitHub Discussions.
• Follow the Code of Conduct.

License

MIT. See LICENSE.