跳到正文
cccskills
免费在 GitHub 公开

ccboard

Launch a terminal or web dashboard to inspect Claude Code activity across projects. Browse sessions, search messages, track token usage and estimated costs, and check MCP servers that connect external tools to the agent.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

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.

查看安装方法

适用场景

  • Checking daily usage and estimated costs
  • Searching past conversations across projects
  • Investigating MCP server status
  • Inspecting configuration inheritance and hooks

包含的文件(11)

  • SKILL.md9.6 KB
  • .claude-plugin/plugin.json1.1 KB
  • commands/costs.md1.7 KB
  • commands/dashboard.md1.3 KB
  • commands/install.md2.3 KB
  • commands/mcp-status.md1.6 KB
  • commands/sessions.md2.0 KB
  • commands/web.md1.8 KB
  • README.md4.1 KB
  • scripts/check-install.sh957 B
  • scripts/install-ccboard.sh2.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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

CommandDescriptionShortcut
/dashboardLaunch TUI dashboardccboard
/mcp-statusOpen MCP servers tabPress 8
/costsOpen costs analysisPress 6
/sessionsBrowse sessionsPress 2
/ccboard-webLaunch web UIccboard web
/ccboard-installInstall/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:

License

MIT OR Apache-2.0


Questions?

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Evaluate Claude Code agents, skills, and commands with weighted quality criteria. Get scores, readiness grades, template comparisons, and practical improvement suggestions in Markdown or JSON reports to guide reviews before release.

中文简介正在准备中。当前显示英语简介。

  • Review skills before release
  • Compare agent definitions with reference templates
  • Quickly check critical quality criteria
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

Assess a codebase across seven areas, including exposed credentials, security, dependencies, structure, and tests. Receive category scores, findings tied to file locations, and a prioritized improvement plan with smaller tasks that can be completed quickly.

中文简介正在准备中。当前显示英语简介。

  • Assessing the overall health of an inherited project
  • Reviewing exposed credentials and security risks
  • Identifying dependency and test coverage gaps
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

Measure code patterns such as casts to any or disabled lint rules, then run repeated, targeted edits. Keep changes that improve the chosen metric, revert unsuccessful changes, and track results for each improvement loop.

中文简介正在准备中。当前显示英语简介。

  • Finding code patterns to prioritize for cleanup
  • Preparing measurement files for an improvement loop
  • Repeating targeted edits to reduce casts to any
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

best-of-n

免费

Generate several separate solutions, compare them against criteria fixed in advance, and verify the selected result through executable checks or an independent reviewer. Keep a proof log documenting candidates, evidence, failures, and remaining limits.

中文简介正在准备中。当前显示英语简介。

  • Comparing implementation options before choosing one
  • Verifying a solution when a wrong choice would be costly
  • Keeping evaluation evidence for delivery or audit
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

canary

免费

Monitor a live application after deployment and compare it with a saved baseline, a record of its earlier state. Check page responses, loading times, and new errors, flag persistent changes, and produce a per-page health report.

中文简介正在准备中。当前显示英语简介。

  • Recording a healthy baseline before deployment
  • Monitoring production immediately after deployment
  • Checking key pages for slower responses or failures
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

catchup

免费

Rebuild project context after clearing a conversation or returning to work. Review recent Git history, uncommitted changes, and TODO markers to get a structured summary of project status and suggested next steps.

中文简介正在准备中。当前显示英语简介。

  • Restoring project context after /clear
  • Reviewing recent changes after a long break
  • Checking unfinished work before choosing the next task
FlorianBruniaux/claude-code-ultimate-guide62022026年10月18日 更新

查看 FlorianBruniaux 的全部技能

报告此技能的问题