ccboard Cheatsheet
Quick reference for commands, keybindings, and workflows
Installation
| Method | Command |
|---|---|
| Homebrew | brew tap FlorianBruniaux/tap && brew install ccboard |
| Cargo | cargo install ccboard |
| From source | git clone && cargo build --release |
Homebrew recommended. Requires Rust 1.85+ for cargo.
Launch Commands
| Command | Description |
|---|---|
| ccboard | Launch TUI (default) |
| ccboard web | Launch web interface (port 3333) |
| ccboard both | Launch TUI + Web simultaneously |
| ccboard stats | Print summary and exit |
| ccboard web --port 8080 | Web interface on custom port |
Keybindings
Tab Navigation
| 1-9 | Jump to specific tab |
| Tab | Next tab |
| Shift+Tab | Previous tab |
List Navigation
| j / ↓ | Move down |
| k / ↑ | Move up |
| h / ← | Move left (in tables) |
| l / → | Move right (in tables) |
| Enter | Select / Open item |
Actions
| / | Search in current tab |
| : | Command palette |
| r | Refresh data |
| e | Edit file in $EDITOR |
| o | Reveal in file manager |
| ? | Show help |
| q | Quit |
| Esc | Close dialog / Cancel |
9 Tabs Overview
| Tab | Purpose |
|---|---|
| 1. Dashboard | Key metrics, model usage, 7-day activity |
| 2. Sessions | Browse sessions, live process detection |
| 3. Config | Cascading config viewer (global/project/local) |
| 4. Hooks | Event-based hook management |
| 5. Agents | Custom AI personas and commands |
| 6. Costs | Token analytics with 4 sub-tabs |
| 7. History | Full-text search with temporal patterns |
| 8. MCP | Server management with status detection |
| 9. Analytics | Budget tracking, trends, insights, forecasting |
Performance
- 89x faster startup with warm cache (20s → 224ms)
- >99% cache hit rate after first run
- 10K+ sessions handled effortlessly
Cache Management
| Location | ~/.cache/ccboard/ |
| Clear cache | ccboard clear-cache |
| Invalidation | Automatic (mtime-based) |
Web Interface
- 100% feature parity with TUI
- Real-time updates via Server-Sent Events
- 9 pages matching TUI tabs
- Responsive design (mobile, tablet, desktop)
Access
| Default URL | http://localhost:3333 |
| Custom port | ccboard web --port 8080 |
Configuration
Claude Code Directory
| Location | ~/.claude/ |
| Sessions | ~/.claude/sessions/ |
| Config | ~/.claude/config.json |
| Hooks | ~/.claude/hooks/ |
ccboard automatically detects changes with 500ms debounce
Quick Tips
- Press
rto force refresh if data seems stale - Use
/for fuzzy search within tabs - Press
1-9to jump directly to any tab - Sessions tab detects live Claude processes (CPU/RAM/Tokens)
- Analytics tab includes 7/30/90-day cost forecasting
- Config tab shows cascading (global → project → local)
- Use
ccboard bothfor simultaneous TUI + Web access
Troubleshooting
| Issue | Solution |
|---|---|
| Slow startup | First run builds cache (~20s), then 224ms |
| Data not updating | Press r to force refresh |
| Web port in use | Use --port 8080 (or any free port) |
| Cache issues | ccboard clear-cache |
Architecture
ccboard
├── TUI (Ratatui)
├── Web (Axum + SSE)
└── Core Library
├── SQLite cache
├── File watcher
└── Session parserBinary size: 5.8MB • Language: Rust • License: MIT OR Apache-2.0 • Tests: 235