Claude Monitor Track token usage, costs, and tool calls for Claude Code sessions

A comprehensive monitoring and visualization tool for Claude Code sessions. Track token usage, costs, tool calls, and session activity through a real-time web dashboard. - Real-time monitoring -- WebSocket-powered live view of active Claude Code sessions - Session tracking -- Automatic capture of session metadata, messages, and tool calls via Claude Code hooks - Log file watching -- Monitors ~/.claude/projects/ for new and modified JSONL log files - Historical import -- Bulk import of existing Claude Code session logs - Cost estimation -- Per-session cost calculation based on configurable model pricing - Full-text search -- Search across all message content using SQLite FTS5 - Token analytics -- Input, output, cache read, and cache write token breakdowns - Tool usage stats -- Track which tools are used most and their success rates - Project breakdown -- Per-project session and cost summaries - Export -- Export sessions as JSON, CSV, or HTML - Web dashboard -- Single-page application with dashboard, sessions, live, tools, projects, cost, and settings pages Build from source: make build Or install to /usr/local/bin : make install # 1. Install hooks and initialize the database claude-monitor install # 2. Import existing Claude Code session logs claude-monitor import # 3. Start the web UI claude-monitor serve # Visit http://localhost:3000 Install Claude Code hooks and initialize the database. claude-monitor install [--force] --force -- Overwrite existing hook configuration Remove hooks and optionally delete all data. claude-monitor uninstall [--delete-data] --delete-data -- Also remove the database and configuration files Start the monitoring daemon and web UI. claude-monitor serve [--port PORT] [--host HOST] [--no-browser] --port -- HTTP port (default: from config, typically 3000)--host -- HTTP host (default: from config, typically 127.0.0.1)--no-browser -- Do not open the browser on start Import historical Claude Code session logs from JSONL files. claude-monitor import [--path PATH] --path -- Path to Claude Code projects directory (default:~/.claude/projects ) Export sessions as JSON, CSV, or HTML. claude-monitor export [--format FORMAT] [--output FILE] [--from DATE] [--to DATE] [--project NAME] --format -- Output format:json ,csv , orhtml (default:json )--output -- Output file path (default: stdout)--from -- Start date filter (RFC3339)--to -- End date filter (RFC3339)--project -- Filter by project name or path Manage configuration. claude-monitor config [--show] [--reset] --show -- Display current configuration--reset -- Reset configuration to defaults Show daemon status and database statistics. claude-monitor status Print version information. claude-monitor version Configuration is stored in ~/.claude-monitor/config.yaml . Key settings: server: port: 3000 host: "127.0.0.1" cost: models: opus: input: 15.0 # $/million tokens output: 75.0 cache_read: 1.5 cache_write: 18.75 sonnet: input: 3.0 output: 15.0 cache_read: 0.3 cache_write: 3.75 haiku: input: 0.25 output: 1.25 cache_read: 0.03 cache_write: 0.3 storage: database_path: "~/.claude-monitor/claude-monitor.db" retention_days: 0 # 0 = keep forever ui: theme: "auto" # auto, light, dark default_page: "dashboard" sessions_per_page: 50 - Hook receiver -- Listens on a Unix socket ( ~/.claude-monitor/monitor.sock ) for real-time hook events from Claude Code - Log watcher -- Uses fsnotify to detect changes to JSONL log files under ~/.claude/projects/ - Ingestion pipeline -- Batches, deduplicates, and writes events to SQLite with FTS5 - REST API -- JSON endpoints for sessions, messages, tool calls, stats, search, and config - WebSocket hub -- Broadcasts real-time events to connected dashboard clients - Web UI -- Embedded static SPA served by the Go binary | Endpoint | Method | Description | |---|---|---| /api/sessions | GET | List sessions (supports project , from , to , limit , offset ) | /api/sessions/{id} | GET | Session detail with messages, tool calls, and subagents | /api/messages | GET | List messages (supports session_id , type , limit , offset ) | /api/tool-calls | GET | List tool calls (supports session_id , tool_name , limit , offset ) | /api/subagents | GET | List subagents (supports session_id , limit , offset ) | /api/stats | GET | Dashboard aggregate statistics | /api/stats/daily | GET | Daily activity for charts (supports days ) | /api/stats/tools | GET | Tool usage breakdown | /api/stats/models | GET | Model usage breakdown | /api/stats/projects | GET | Project activity breakdown | /api/search | GET | Full-text search on messages (requires q ) | /api/config | GET/POST | Get or update configuration | /ws | WebSocket | Real-time event stream | # Run tests make test # Build make build # Run make run Apache License 2.0 -- see LICENSE for details.