ccboard - Claude Code Dashboard

ccboard - Claude Code Dashboard

Comprehensive TUI/Web dashboard for monitoring and managing your Claude Code usage.

Overview

ccboard provides a unified interface to visualize and explore all your Claude Code data:

• **Sessions**: Browse all conversations across your projects
• **Statistics**: Real-time token usage, cache hit rates, activity trends
• **MCP Servers**: Monitor and manage Model Context Protocol servers
• **Costs**: Track spending with detailed token breakdown and pricing
• **Configuration**: View cascading settings (Global > Project > Local)
• **Hooks**: Explore pre/post execution hooks and automation
• **Agents**: Manage custom agents, commands, and skills
• **History**: Search across all messages with full-text search

Installation

Via Cargo (Recommended)

# Using Claude Code command
/ccboard-install

# Or manually
cargo install ccboard

Requirements

• Rust 1.70+ and Cargo
• Claude Code installed (reads from `~/.claude/`)

Commands

| Command | Description | Shortcut | |---------|-------------|----------| | `/dashboard` | Launch TUI dashboard | `ccboard` | | `/mcp-status` | Open MCP servers tab | Press `8` | | `/costs` | Open costs analysis | Press `6` | | `/sessions` | Browse sessions | Press `2` | | `/ccboard-web` | Launch web UI | `ccboard web` | | `/ccboard-install` | Install/update ccboard | - |

Features

8 Interactive Tabs

#### 1. Dashboard (Press `1`)

• Token usage statistics
• Session count
• Messages sent
• Cache hit ratio
• MCP server count
• 7-day activity sparkline
• Top 5 models usage gauges

#### 2. Sessions (Press `2`)

• Dual-pane: Project tree + Session list
• Metadata: timestamps, duration, tokens, models
• Search: Filter by project, message, or model (press `/`)
• File operations: `e` to edit JSONL, `o` to reveal in finder

#### 3. Config (Press `3`)

• 4-column cascading view: Global | Project | Local | Merged
• Settings inheritance visualization
• MCP servers configuration
• Rules (CLAUDE.md) preview
• Permissions, hooks, environment variables
• Edit config with `e` key

#### 4. Hooks (Press `4`)

• Event-based hook browsing (PreToolUse, UserPromptSubmit)
• Hook bash script preview
• Match patterns and conditions
• File path tracking for easy editing

#### 5. Agents (Press `5`)

• 3 sub-tabs: Agents (12) | / Commands (5) | ★ Skills (0)
• Frontmatter metadata extraction
• File preview and editing
• Recursive directory scanning

#### 6. Costs (Press `6`)

• 3 views: Overview | By Model | Daily Trend
• Token breakdown: input, output, cache read/write
• Pricing: total estimated costs
• Model distribution breakdown

#### 7. History (Press `7`)

• Full-text search across all sessions
• Activity by hour histogram (24h)
• 7-day sparkline
• All messages searchable

#### 8. MCP (Press `8`) **NEW**

• Dual-pane: Server list (35%) | Details (65%)
• Live status detection: ● Running, ○ Stopped, ? Unknown
• Full server details: command, args, environment vars
• Quick actions: `e` edit config, `o` reveal file, `r` refresh status

Navigation

**Global Keys**:

• `1-8` : Jump to tab
• `Tab` / `Shift+Tab` : Navigate tabs
• `q` : Quit
• `F5` : Refresh data

**Vim-style**:

• `h/j/k/l` : Navigate (left/down/up/right)
• `←/→/↑/↓` : Arrow alternatives

**Common Actions**:

• `Enter` : View details / Focus pane
• `e` : Edit file in $EDITOR
• `o` : Reveal file in finder
• `/` : Search (in Sessions/History tabs)
• `Esc` : Close popup / Cancel

Real-time Monitoring

ccboard includes a file watcher that monitors `~/.claude/` for changes:

• **Stats updates**: Live refresh when `stats-cache.json` chan

<!-- truncated -->