TUI Interface Web Interface MIT OR Apache-2.0 License Version Platform Rust 1.85+
🎉 Latest Release: v0.5.2 - SEO, Homebrew & UX Improvements

The Dashboard Claude Code Deserves

Real-time monitoring • Budget alerts • 30-day forecasting

ccboard TUI demo showing session monitoring, live stats, and navigation
Install with Homebrew

or view on GitHub

9 tabs 281 tests 89x speedup 5.8MB binary
📐 View Architecture Diagram 
┌─────────────────────────────────────────────────┐
│                  ccboard                        │
│              (Binary CLI)                       │
└─────────────────┬───────────────────────────────┘
                  │
        ┌─────────┴──────────┐
        │                    │
┌───────▼────────┐  ┌────────▼────────┐
│  ccboard-tui   │  │  ccboard-web    │
│  (Ratatui 9    │  │  (Axum API +    │
│   tabs)        │  │   Leptos UI)    │
└───────┬────────┘  └────────┬────────┘
        │                    │
        └─────────┬──────────┘
                  │
        ┌─────────▼──────────┐
        │   ccboard-core     │
        │  (Data layer +     │
        │   SQLite cache)    │
        └────────────────────┘

Everything You Need to Monitor Claude Code

💰

Cost Tracking

Budget alerts, 30-day forecasting, billing blocks

  • Costs
  • Analytics
  • History
🔍

Session Monitoring

Live processes (CPU/RAM/Tokens), search, detail view

  • Sessions
  • Dashboard
⚙️

Config Management

3-level merge, hooks, agents, MCP servers

  • Config
  • Hooks
  • Agents
  • MCP
View all 9 tabs in detail →
📊

Dashboard

Overview stats, model usage, MCP servers, 7-day activity, API usage estimation with plan budgets.

🔍

Sessions

Browse all sessions with search, live Claude processes with CPU/RAM/Tokens, detail view.

⚙️

Config

Cascading configuration editor (global/project/local) with 4-column diff view.

🔗

Hooks

Event-based hook management with bash syntax highlighting and test mode.

🤖

Agents

Browse agents, commands, and skills with frontmatter YAML parsing and invocation stats.

💰

Costs

Token analytics with 4 tabs: Overview, By Model, Daily costs, Billing Blocks.

🕐

History

Full-text search across sessions with temporal patterns, filters, and CSV/JSON export.

🔌

MCP

Server management with status detection and env vars display.

📈

Analytics

Advanced analytics with 4 sub-views: Budget tracking, Trends, Patterns, Insights.

Instant Startup, Even With Thousands of Sessions

Claude Code stores every session as a JSONL file in ~/.claude. After a few months, you accumulate thousands of files and gigabytes of data. Parsing all of that on every launch would take 20+ seconds.

ccboard solves this with a local SQLite cache: it scans your files once, then loads from cache on every subsequent launch. The result?

20s → 224ms
Startup Time
89x faster after first launch thanks to SQLite cache
10K+
Sessions Supported
Scales with your usage, no slowdown over time
>99%
Cache Hit Rate
Only changed files are re-parsed, the rest is instant
How it works under the hood →
Scenario What happens Time
First launch Scans all JSONL files, builds SQLite cache ~20s (one-time)
Every next launch Loads from cache, re-parses only changed files 224ms
New session created File watcher detects change, updates cache incrementally <500ms
  • SQLite with WAL mode: concurrent reads while writing
  • mtime-based invalidation: only re-parse files that actually changed
  • Metadata-only scan: full session content loaded on-demand, not at startup
  • Parallel directory scanning: multiple project folders scanned concurrently

See It In Action

TUI Dashboard - Key Metrics & Model Usage

Dashboard with overview stats and 7-day activity

TUI Sessions Browser with live process monitoring

Sessions browser with live CPU/RAM/Tokens monitoring

TUI Configuration Viewer

Configuration viewer with 4-column diff

TUI Hooks Management

Hooks management with syntax highlighting

TUI Agents Manager

Agents manager with custom persona configurations

TUI Cost Analytics

Cost analytics with billing blocks and token breakdown

TUI History Search

History search with temporal patterns

TUI MCP Servers Status

MCP servers status with environment variables

TUI Analytics with budget tracking and trends

Advanced analytics with budget tracking and trends

Web Dashboard - Real-time Metrics

Web dashboard with interactive charts and live stats

Web Sessions List

Browse sessions with search, filters, and pagination

Web Configuration Panel

Visual configuration editor with live validation

Web Hooks Manager

Hook editor with syntax highlighting and test runner

Web Agents Browser

Browse and configure custom AI personas

Web Cost Dashboard

Interactive cost analytics with charts and breakdowns

Web History Timeline

Timeline view of all Claude Code activities

Web MCP Status

MCP server monitoring with real-time status

Web Analytics Dashboard

Advanced analytics with forecasting and insights

Learning Paths

Choose your path based on your needs and available time

⚡ Quick Start (5 min) - Get running immediately
  1. Install: brew tap FlorianBruniaux/tap && brew install ccboard
  2. Launch TUI: ccboard
  3. Navigate: Use 1-9 to jump between tabs, Tab to cycle
  4. Explore: Dashboard (tab 1) for overview, Sessions (tab 2) for recent activity

Goal: See your Claude Code stats and sessions in under 5 minutes

📊 Session Monitoring (10 min) - Track live Claude processes
  1. Sessions tab (2): See all your sessions with live process monitoring
  2. Live processes: Active Claude sessions show CPU/RAM/Tokens in real-time
  3. Search: Press / to search sessions by content or project
  4. Detail view: Press Enter for full session metadata (17 fields)
  5. CLI search: ccboard search "bug fix"

Goal: Monitor active sessions and search historical activity

⚙️ Configuration & Budget (15 min) - Customize your setup
  1. Config tab (3): See 4-column diff (global/project/local/merged)
  2. Set plan: Edit ~/.claude/settings.json → {"subscriptionPlan": "max20x"}
  3. Budget alerts: Add {"budget": {"monthlyBudgetUsd": 50.0, "alertThresholdPct": 80.0}}
  4. Analytics tab (9): See budget status with visual warnings (green/yellow/red)
  5. Hooks tab (4): Test your hooks with syntax highlighting

Goal: Configure subscription plan and set up budget alerts

🚀 Power Users (30 min) - Master advanced features
  1. CLI workflow: Use ccboard recent 10 --json for scripting
  2. Resume sessions: ccboard resume <id> to continue work seamlessly
  3. Analytics (tab 9): 30-day forecasting, usage patterns, session duration stats
  4. Export data: History tab → CSV/JSON export for analysis
  5. Web interface: ccboard web --port 3333 for browser access
  6. Dual mode: ccboard both --port 3333 runs TUI + Web simultaneously
  7. Env vars: CCBOARD_FORMAT=json ccboard stats for CI/CD integration

Goal: Integrate ccboard into your workflow with CLI, web interface, and automation

Why ccboard?

The only actively-maintained Rust TUI combining Claude Code monitoring, config management, hooks, agents, and MCP servers in a single 5.8MB binary.

Feature ccboard agtrace claudelytics ccusage
Status ✅ Active ✅ Active 🔴 Stale 6m ✅ Active
Stars 0 23 62 10,361
Language Rust Rust Rust TypeScript
Type TUI+Web TUI TUI CLI
TUI Dashboard ✅ 9 tabs ✅ Single view ✅ 8 tabs ❌
Config Viewer (3-level) ✅ ❌ ❌ ❌
Hooks Viewer + Test ✅ ❌ ❌ ❌
Agents Browser ✅ ❌ ❌ ❌
MCP Status Detection ✅ ❌ ❌ ❌
SQLite Cache (89x) ✅ ✅ Pointer ❌ ❌
Export CSV/JSON ✅ ❌ ✅ ✅ JSON
Live File Watcher ✅ ✅ Poll 1s ❌ ❌
Advanced Analytics ✅ 4 views ❌ ⚠️ Burn rate ❌
Single Binary ✅ 5.8MB ✅ Rust ✅ Rust ❌ npm

Unique to ccboard

  • Only multi-concern dashboard (config + hooks + agents + MCP + analytics)
  • Config 3-level merge viewer (global/project/local)
  • Hooks syntax highlighting + test mode
  • Agents/Commands/Skills browser with invocation stats
  • MCP server status detection
  • SQLite metadata cache (89x faster startup)
  • Advanced Analytics: 30-day forecasting, budget alerts, session duration stats
  • Dual TUI + Web in single binary

Quick Start

Get started in 30 seconds:

Recommended: Homebrew

bash 
brew tap FlorianBruniaux/tap
brew install ccboard

macOS & Linux users: Fastest installation method with automatic updates

Alternative: cargo install
bash 
cargo install ccboard

Requirements: Rust 1.85+ (Claude Code users already have Rust installed)

Pre-built binaries: Available from GitHub Releases

Launch Dashboard

bash 
# TUI (default)
ccboard

# Web interface
ccboard web --port 3333

# Both TUI + Web
ccboard both --port 3333

# Stats summary
ccboard stats

CLI Commands (v0.4.0+)

bash 
# Session management
ccboard search "query"       # Search sessions by content
ccboard recent 10            # Show 10 most recent sessions
ccboard info <session-id>    # Display detailed session metadata
ccboard resume <session-id>  # Resume session in Claude CLI

# Maintenance
ccboard clear-cache          # Clear SQLite cache (after upgrades)

All commands support JSON output: ccboard recent 10 --json

Keybindings

bash 
# Navigation
1-9        Jump to specific tab
Tab        Next tab
j/k        Move down/up (vim style)
/          Search (Sessions, History)
:          Command palette

# File operations
e          Edit file in $EDITOR
o          Reveal in file manager

# Other
r          Refresh data
?          Show help
q          Quit

Environment Variables

For automation and CI/CD workflows:

Variable Description Example
CCBOARD_CLAUDE_HOME Override Claude home directory CCBOARD_CLAUDE_HOME=/custom/path ccboard
CCBOARD_NON_INTERACTIVE Disable interactive prompts (CI/CD mode) CCBOARD_NON_INTERACTIVE=1 ccboard stats
CCBOARD_FORMAT Force output format: json or table CCBOARD_FORMAT=json ccboard recent 10
CCBOARD_NO_COLOR Disable ANSI colors (log-friendly) CCBOARD_NO_COLOR=1 ccboard search "bug"
bash 
# CI/CD: JSON output without colors
CCBOARD_NON_INTERACTIVE=1 CCBOARD_NO_COLOR=1 CCBOARD_FORMAT=json ccboard stats

# Log-friendly: No colors for file redirects
CCBOARD_NO_COLOR=1 ccboard recent 50 > sessions.log

Full documentation →

FAQ

What is ccboard?

ccboard is a unified TUI/Web dashboard for Claude Code management. It provides 9 interactive tabs for monitoring sessions, analyzing costs, managing config, hooks, agents, and MCP servers. Built in Rust with a 5.8MB binary.

How does the cache work?

ccboard uses SQLite to cache session metadata with mtime-based invalidation. This provides an 89x speedup (20s → 224ms) after the first run, with >99% cache hit rate. The cache only stores metadata; full session content is loaded on-demand.

Does it work on Linux/Windows?

Yes! ccboard supports macOS (fully tested), Linux (community-tested), and Windows (experimental). Platform-specific features like file manager integration are cross-platform compatible.

How much does it cost?

ccboard is free and open-source, licensed under MIT OR Apache-2.0. No subscription, no hidden costs. The cost analytics features help you track your Claude API usage.

Can I use the web interface?

Yes! Run ccboard web --port 3333 for the web UI, or ccboard both to run TUI + Web simultaneously. The web interface has 100% feature parity with the TUI (9 pages).

Does it support real-time monitoring?

Yes! ccboard includes a file watcher that monitors ~/.claude changes with 500ms debounce. Live updates appear in both TUI and Web (via Server-Sent Events). The Sessions tab also detects live Claude processes with CPU/RAM/Token metrics.

What's the difference with ccusage/agtrace?

ccusage (10K stars) is a CLI cost tracker (no dashboard). agtrace (23 stars) focuses on observability with MCP self-reflection. ccboard is the only multi-concern dashboard combining config, hooks, agents, MCP status, and advanced analytics with forecasting in a single TUI+Web binary.

What's new in v0.5.0?

Sprint 1 UX/UI improvements with 60% visual enhancement:

  • Visual Design System: 4-level elevation shadows, improved contrast (+16 luminosity), semantic border radius
  • Config Page: Real-time search with highlighting, one-click JSON copy, fullscreen modal viewer
  • Dashboard: Clickable KPI cards for navigation, session preview tooltips on hover
  • Bug Fixes: Cost calculation now shows accurate Anthropic pricing (was $0.00), fixed "model unknown" in History

714 additions across 7 files. See full changelog.

How do I track my budget?

Configure custom monthly budgets with automatic alerts in the Analytics tab (Tab 9):

  1. Edit ~/.claude/settings.json
  2. Add: {"budget": {"monthlyBudgetUsd": 50.0, "alertThresholdPct": 80.0}}
  3. Launch ccboard and go to Analytics tab (press 9)
  4. See budget status with visual warnings (🟢 safe / 🟡 caution / 🔴 warning)

Alert types: Budget warning (≥80%), projected overage (forecast), usage spike (anomaly detection).

Does it support Homebrew?

Yes! Homebrew is the recommended installation method for macOS and Linux users:

brew tap FlorianBruniaux/tap
brew install ccboard

Benefits: Automatic updates via brew upgrade, clean uninstall with brew uninstall ccboard, no Rust toolchain required. Added in v0.5.1.

How do I contribute?

Contributions welcome! See CONTRIBUTING.md for guidelines. Fork the repo, create a feature branch, run tests (cargo test --all), and open a Pull Request. Zero clippy warnings required.

💡 Feedback