Claude-Code-Agent-Monitor
### Architecture & Positioning Claude-Code-Agent-Monitor (CCAM) is a local-first observability dashboard and session tracking system engineered specifically for terminal AI coding agents, including Claude Code, Cursor, and Codex. When agents execute long-running autonomous workflows across multi-file edits, compiler tests, and bash scripts, tracking context bloat, sub-agent spawning, and tool-call latency inside standard CLI scrolling becomes nearly impossible. CCAM resolves this observability deficit by passively discovering local JSONL session transcripts and hook events, rendering a unified, real-time control plane in a browser dashboard or native macOS app. ### Core Capabilities & Differentiation CCAM's defining advantage lies in its multi-provider aggregation and hierarchical task deconstruction. Rather than displaying an undifferentiated stream of tool outputs, CCAM reconstructs conversations into intuitive parent-child agent trees, detailing sub-agent delegations, tool arguments, and execution runtimes. Developers gain full-text search across historical transcripts, live token-to-cost conversion estimators, and interactive task controls that let users inspect, resume, or replay paused agent trajectories directly from the UI. ### Deployment & Best Practices To set up CCAM, install the package via Node.js (22+) and configure provider hooks in your shell configuration or local agent settings so session logs are mirrored to the monitored path. Because CCAM is strictly local-first, no code snippets, prompts, or sensitive environment secrets are ever transmitted to third-party tracking servers, making it compliant for enterprise proprietary codebases. Keep the dashboard pinned to a secondary monitor or terminal split pane to maintain constant visibility over long-running coding agents.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-12
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 22
- Latest release
- v2.4.6 (2026-11-12)
- Open issues
- 44
- Recent issues with at least one comment
- 1/5
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #376 [Feature]: Support Google Antigravity CLI (agy) and Hermes Agent sessions2 comments · 2026-10-17
- #197 i18n: community translations for new languages (Spanish, German, French, ...) -- contributors welcome2 comments · 2026-06-29
- #315 [Feature]: Trim hook payloads before storing events.data (whole-file mirrors grew my DB to 2 GB)1 comments · 2026-09-03
- #305 [Feature]: Tiered retention with rollup-before-delete so history shrinks instead of disappearing1 comments · 2026-08-24
- #149 Feature: Local-first backup, restore, and sync workflow1 comments · 2026-05-12
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!