Frequently Asked Questions

ccboard is a unified TUI/Web dashboard for Claude Code management. It provides 9 interactive tabs covering sessions, costs, config, hooks, agents, MCP servers, and analytics. Built in Rust — single binary, 5.8MB, no external runtime required.

The recommended method is Homebrew (no Rust toolchain needed):

brew tap FlorianBruniaux/tap && brew install ccboard

Or install from crates.io: cargo install ccboard. Then launch with ccboard (TUI), ccboard web (Web UI), or ccboard both (TUI + Web simultaneously).

Yes. macOS is fully tested. Linux is community-tested and works well. Windows is experimental — core features work, some platform-specific integrations may vary.

ccboard uses SQLite to cache session metadata with mtime-based invalidation. On first run it indexes your sessions (can take ~20s for large histories). Subsequent runs hit the cache at >99% hit rate, dropping load time to ~224ms — an 89x speedup. The cache stores only metadata; full session content is loaded on-demand.

Yes. A file watcher monitors ~/.claude changes with a 500ms debounce. Live updates stream to both TUI and Web via Server-Sent Events. The Sessions tab detects running Claude processes and shows live CPU, RAM, and token metrics.

Yes. Run ccboard web --port 3333 for the web UI only. Run ccboard both to run TUI and Web simultaneously. The web interface has 100% feature parity with the TUI — all 9 tabs, real-time updates, and full search.

Open the Analytics tab (Tab 9). In ~/.claude/settings.json, add a budget object with monthlyBudgetUsd and alertThresholdPct fields. ccboard then displays budget status with visual warnings and spend forecasting based on your usage trend.

Yes — Homebrew is the recommended installation method. Benefits: automatic updates (brew upgrade ccboard), clean uninstall, no Rust toolchain required. Tap: FlorianBruniaux/tap.

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

ccusage (~10K stars) is a CLI cost tracker — no dashboard, no config management, no live monitoring. agtrace focuses on observability via MCP self-reflection. ccboard is the only multi-concern dashboard combining config, hooks, agents, MCP status, cost analytics, and live session monitoring in a single TUI+Web binary.

v0.8.0 added Budget Tracking & Quota Management: month-to-date cost calculation with intelligent token-based prorata, monthly projection, 4-level alert system (safe/warning/critical/exceeded), quota gauge in the Costs tab, and REST API endpoint /api/quota. See the full CHANGELOG on GitHub.

Contributions are welcome. See CONTRIBUTING.md for guidelines. Fork the repo, create a feature branch, run cargo test --all, and open a Pull Request. Zero clippy warnings required. Bug reports and feature requests via GitHub Issues are also very helpful.