ccboard is a unified TUI/Web dashboard for Claude Code management. It provides 11 interactive tabs for monitoring sessions, analyzing costs, managing config, hooks, agents, MCP servers, and security auditing. 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.

Does it work on Linux/Windows?

Yes! ccboard supports macOS (fully tested), Linux (community-tested), and Windows (experimental).

How much does it cost?

ccboard is free and open-source, licensed under MIT OR Apache-2.0. No subscription, no hidden costs.

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.

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.

What's the difference with ccusage/agtrace?

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

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

Latest: v0.11.1 — Activity Security Audit + FTS5 Search 🔒 Security Audit — Now Live

The Dashboard Claude Code Deserves

Real-time monitoring • Budget alerts • 30-day forecasting • Security audit • Light/Dark mode

ccboard TUI demo showing session monitoring, live stats, and navigation

Install with Homebrew

or view on GitHub

15 stars 208 downloads 11 tabs 377 tests 89x speedup 5.8MB binary

View Architecture Diagram

terminal

Everything You Need to Monitor Claude Code

💰

Cost Tracking

Budget alerts, 30-day forecasting, billing blocks

CostsAnalyticsHistory

🔍

Session Monitoring

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

SessionsDashboard

⚙️

Config Management

3-level merge, hooks, agents, MCP servers

ConfigHooksAgentsMCP

🔒

Security Audit

Cross-session violations feed, destructive command detection, credential exposure alerts

Activity

View all 10 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

Budget quota gauge with 4-level alerts (Safe/Warning/Critical/Exceeded), MTD cost, monthly projection, billing blocks export.

🕐

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.

🔒

Activity

Security audit tab (press `a`): per-session file/bash/network tool calls, cross-session violations feed sorted Critical→Warning→Info with remediation hints.

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. ccboard solves this with a local SQLite cache: it scans your files once, then loads from cache on every subsequent launch.

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
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

Configuration viewer with 4-column diff

Hooks management with syntax highlighting

Agents manager with custom persona configurations

Cost analytics with billing blocks and token breakdown

History search with temporal patterns

MCP servers status with environment variables

TUI Analytics with budget tracking and trends

Advanced analytics with budget tracking and trends

TUI Activity Security Audit - Sessions + Violations feed

Activity tab (press `a`): security audit with violations feed sorted by severity

Web dashboard with interactive charts and live stats

Browse sessions with search, filters, and pagination

Visual configuration editor with live validation

Hook editor with syntax highlighting and test runner

Browse and configure custom AI personas

Interactive cost analytics with charts and breakdowns

Timeline view of all Claude Code activities

MCP server monitoring with real-time status

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

Install: brew tap FlorianBruniaux/tap && brew install ccboard
Launch TUI: ccboard
Navigate: Use 1-9 to jump between tabs, Tab to cycle
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

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

Goal: Monitor active sessions and search historical activity

⚙️ Configuration & Budget (15 min) - Customize your setup

Config tab (3): See 4-column diff (global/project/local/merged)
Set plan: {"subscriptionPlan": "max20x"}
Budget alerts: {"budget": {"monthlyBudgetUsd": 50.0, "alertThresholdPct": 80.0}}
Analytics tab (9): See budget status with visual warnings (green/yellow/red)
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

CLI workflow: ccboard recent 10 --json
Resume sessions: ccboard resume <id>
Analytics (tab 9): 30-day forecasting, usage patterns, session duration stats
Export data: History tab → CSV/JSON export for analysis
Web interface: ccboard web --port 3333
Dual mode: ccboard both --port 3333
Env vars: CCBOARD_FORMAT=json ccboard stats

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	❌
Budget / Quota Management	✅ 4-level alerts	❌	❌	❌
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, session duration stats, activity patterns
• Monthly budget limits with 4-level quota system (Safe → Warning → Critical → Exceeded) and MTD cost tracking
• Dual TUI + Web in single binary

Dive Deeper

Explore the full documentation to get the most out of ccboard.

🚀

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

keybindings

# 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

# Theme
Ctrl+T     Toggle Light/Dark mode (persistent)

# 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 →

Feedback

The Dashboard Claude Code Deserves

Everything You Need to Monitor Claude Code

Cost Tracking

Session Monitoring

Config Management

Security Audit

Dashboard

Sessions

Config

Hooks

Agents

Costs

History

MCP

Analytics

Activity

Instant Startup, Even With Thousands of Sessions

See It In Action

Learning Paths

Why ccboard?

Unique to ccboard

Dive Deeper

Getting Started →

9 Tabs Guide →

Configuration →

CLI Commands →

Web Interface →

Performance →

Quick Start

Recommended: Homebrew

Launch Dashboard

CLI Commands (v0.4.0+)

Keybindings

Environment Variables

The Dashboard Claude Code Deserves

Everything You Need to Monitor Claude Code

Cost Tracking

Session Monitoring

Config Management

Security Audit

Dashboard

Sessions

Config

Hooks

Agents

Costs

History

MCP

Analytics

Activity

Instant Startup, Even With Thousands of Sessions

See It In Action

Learning Paths

Why ccboard?

Unique to ccboard

Dive Deeper

Getting Started →

9 Tabs Guide →

Configuration →

CLI Commands →

Web Interface →

Performance →

Quick Start

Recommended: Homebrew

Launch Dashboard

CLI Commands (v0.4.0+)

Keybindings

Environment Variables

Related Projects

Claude Code Ultimate Guide

cc-copilot-bridge

RTK - Rust Token Killer

Cowork Guide