How do I install the Ccboard skill?

Run npx skillmds@latest add arogyareddy/ccboard in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Ccboard skill do?

Launch and navigate the ccboard TUI/Web dashboard for Claude Code. Use when monitoring token usage, tracking costs, browsing sessions, or checking MCP server status across projects. It is listed under AI & ML on SkillMD.

Is Ccboard safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ccboard?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ccboard free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ccboard?

arogyareddy (@arogyareddy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ccboard by arogyareddy — Agent Skill

Name: Ccboard
Author: arogyareddy

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 changes
Session updates: New sessions appear automatically
Config updates: Settings changes reflected in UI
500ms debounce: Prevents excessive updates

File Editing

Press e on any item to open in your preferred editor:

Uses $VISUAL > $EDITOR > platform default (nano/notepad)
Supports: Sessions (JSONL), Config (JSON), Hooks (Shell), Agents (Markdown)
Terminal state preserved (alternate screen mode)
Cross-platform (macOS, Linux, Windows)

MCP Server Management

The MCP tab provides comprehensive server monitoring:

Status Detection (Unix):

Checks running processes via ps aux
Extracts package name from command
Displays PID when running
Windows shows "Unknown" status

Server Details:

Full command and arguments
Environment variables with values
Config file path (~/.claude/claude_desktop_config.json)
Quick edit/reveal actions

Navigation:

h/l or ←/→ : Switch between list and details
j/k or ↑/↓ : Select server
Enter : Focus detail pane
e : Edit MCP config
o : Reveal config in finder
r : Refresh server status

Usage Examples

Daily Monitoring

# Launch dashboard
/dashboard

# Check activity and costs
# Press '1' for overview
# Press '6' for costs breakdown
# Press '7' for recent history

MCP Troubleshooting

# Open MCP tab
/mcp-status

# Or: ccboard then press '8'

# Check server status (● green = running)
# Press 'e' to edit config if needed
# Press 'r' to refresh status after changes

Session Analysis

# Browse sessions
/sessions

# Press '/' to search
# Filter by project: /my-project
# Filter by model: /opus
# Press 'e' on session to view full JSONL

Cost Tracking

# View costs
/costs

# Press '1' for overview
# Press '2' for breakdown by model
# Press '3' for daily trend

# Identify expensive sessions
# Track cache efficiency (99.9% hit rate)

Web Interface

Launch browser-based interface for remote monitoring:

# Launch web UI
/ccboard-web

# Or with custom port
ccboard web --port 8080

# Access at http://localhost:3333

Features:

Same data as TUI (shared backend)
Server-Sent Events (SSE) for live updates
Responsive design (desktop/tablet/mobile)
Concurrent multi-user access

Run both simultaneously:

ccboard both --port 3333

Architecture

ccboard is a single Rust binary with dual frontends:

ccboard/
├── ccboard-core/      # Parsers, models, data store, watcher
├── ccboard-tui/       # Ratatui frontend (8 tabs)
└── ccboard-web/       # Axum + Leptos frontend

Data Sources:

~/.claude/stats-cache.json - Statistics
~/.claude/claude_desktop_config.json - MCP config
~/.claude/projects/*/ - Session JSONL files
~/.claude/settings.json - Global settings
.claude/settings.json - Project settings
.claude/settings.local.json - Local overrides
.claude/CLAUDE.md - Rules and behavior

Troubleshooting

ccboard not found

# Check installation
which ccboard

# Install if needed
/ccboard-install

No data visible

# Verify Claude Code is installed
ls ~/.claude/

# Check stats file exists
cat ~/.claude/stats-cache.json

# Run with specific project
ccboard --project ~/path/to/project

MCP status shows "Unknown"

Status detection requires Unix (macOS/Linux)
Windows shows "Unknown" by default
Check if server process is actually running: ps aux | grep <server-name>

File watcher not working

Ensure notify crate supports your platform
Check file permissions on ~/.claude/
Restart ccboard if file system events missed

Advanced Usage

Command-line Options

ccboard --help              # Show all options
ccboard --claude-home PATH  # Custom Claude directory
ccboard --project PATH      # Specific project
ccboard stats               # Print stats and exit
ccboard web --port 8080     # Web UI on port 8080
ccboard both                # TUI + Web simultaneously

Environment Variables

# Editor preference
export EDITOR=vim
export VISUAL=code

# Custom Claude home
export CLAUDE_HOME=~/custom/.claude

Integration with Claude Code

ccboard reads read-only from Claude Code directories:

Non-invasive monitoring
No modifications to Claude data
Safe to run concurrently with Claude Code
File watcher detects changes in real-time

Performance

Binary size: 2.4MB (release build)
Initial load: <2s for 1,000+ sessions
Memory: ~50MB typical usage
CPU: <5% during monitoring
Lazy loading: Session content loaded on-demand

Limitations

Current version (0.1.0):

Read-only: No write operations to Claude data
MCP status: Unix only (Windows shows "Unknown")
Web UI: In development (TUI is primary interface)
Search: Basic substring matching (no fuzzy search yet)

Future roadmap:

Enhanced MCP server management (start/stop)
MCP protocol health checks
Export reports (PDF, JSON, CSV)
Config editing (write settings.json)
Session resume integration
Enhanced search with fuzzy matching

Contributing

ccboard is open source (MIT OR Apache-2.0).

Repository: https://github.com/{OWNER}/ccboard

Contributions welcome:

Bug reports and feature requests
Pull requests for new features
Documentation improvements
Platform-specific testing (Windows, Linux)

Credits

Built with:

Ratatui - Terminal UI framework
Axum - Web framework
Leptos - Reactive frontend
Notify - File watcher
Serde - Serialization

License

MIT OR Apache-2.0

Questions?

GitHub Issues: https://github.com/{OWNER}/ccboard/issues
Documentation: https://github.com/{OWNER}/ccboard
Claude Code: https://claude.ai/code

Ccboard

File contents