开源 · MIT License · 为 Claude Code 而生

你的 Claude Code
会话监控面板

实时掌握多个 Claude Code 会话的运行状态、事件流与历史记录。
谁在等确认、谁在出错、谁跑完了 —— 一眼看清,不再逐个终端切换。

5 种会话状态实时推断
2 种发布形态(桌面 / 服务端)
0 依赖Hook 全程离线工作
1 个单文件即可部署
事件流
历史会话
用量
设置
活跃会话 · 4
refactor-auth-module运行中
~/.claude/projects/api-server
fix-payment-bug等待确认
~/.claude/projects/web-app
write-api-docs等待输入
~/.claude/projects/docs
migrate-db-schema出错
~/.claude/projects/infra
add-unit-tests已完成
~/.claude/projects/api-server
事件流 · refactor-auth-module
U
用户输入

把 JWT 校验抽成独立中间件…

14:02:11
T
PreToolUse

Read · src/auth/jwt.ts

14:02:13
✓
PostToolUse

Read 完成(1.2k tokens)

14:02:14
T
PreToolUse

Edit · src/auth/middleware.ts

14:02:19
✓
PostToolUse

Edit 完成 · +42 −18

14:02:21
T
PreToolUse

Bash · cargo test --lib

14:02:25
N
Notification

Claude 正在等待你的输入

14:02:30
SSE 已连接 hooks: 3 已注册 增量解析 · mtime 缓存命中
Preview

一睹为快

界面长什么样?一张图说话。

CCBuddy 用量面板 · Usage panel

用量面板

用量卡片、Token 消耗趋势、活跃热力图与构成占比一览。

Features

专为重度 Claude Code 用户打造

开了十个终端并行干活?CCBuddy 把所有会话装进一块面板,状态变化第一时间知道。

⚡

实时事件流

通过 Claude Code Hooks 采集每次工具调用、用户输入与通知,按会话分文件存储 JSONL 日志,面板实时呈现每个会话正在发生什么。

🧠

智能状态机

事件序列驱动状态推断:运行中 / 等待确认 / 等待输入 / 出错 / 已完成 五种状态一目了然,等待确认与出错自动标记未读,绝不漏掉需要你处理的那一刻。

💬

历史会话回放

直接读取 Claude Code 原生会话记录(~/.claude/projects/),以聊天记录形式回放完整对话,只读零侵入,不改动任何原始数据。

📊

用量统计

趋势图 + 环形图直观展示 token 消耗与用量分布,自动刷新周期可调,花的每一批 token 都看得见、算得清。

🔔

任务栏提醒

桌面端支持任务栏角标与窗口闪烁提醒,会话等待确认或出错时即使最小化也不会错过,切回来处理完继续跑。

🌐

中英双语

界面内建中英文切换,桌面端与服务端共用同一套前端,所有视图、状态徽标与图表文案完整覆盖。

How it works

三步接线,零侵入采集

不改 Claude Code 本体、不联网上报,一条 Hook 管道把事件送进面板。

🪝

① Hook 采集

设置页一键安装 Hooks 到 settings.json,ccbuddy-hook 把事件原样落盘

→
📁

② 本地日志

按会话分文件追加写入 ~/.ccbuddy/events/,纯文本 JSONL,随时可审计

→
🖥️

③ 面板呈现

按 mtime 增量解析 + 状态机推断,每会话保留最新 50 条事件,资源占用极低

历史会话视图直接只读 ~/.claude/projects/ 原生记录 · 全程离线,hook 无需联网

Two forms

桌面端 & 服务端,一套前端两种姿势

前后端通过统一 RPC 协议通信,业务代码不接触 Tauri / HTTP 细节 —— 同一个界面,既能跑在桌面上,也能跑在服务器里。

桌面端
💻

Tauri 2 原生应用

Windows · Linux · macOS
  • 原生窗口 + 任务栏角标 / 窗口闪烁提醒
  • 前端 Vue3 + Naive UI,体积轻、启动快
  • 本地直接读写,无需任何网络配置
# 开发调试
npm install
npm run tauri dev

# 打包发布
npm run tauri build
服务端 · 推荐
🖥️

ccbuddy-server 无头部署

Linux 服务器 · 浏览器访问
  • 前端产物编译期嵌入二进制,单文件部署
  • SSE 实时推送,手机 / 平板浏览器随时查看
  • 强制密码验证,Argon2id 哈希落盘
# 构建单文件二进制
cargo build --no-default-features --bin ccbuddy-server

# 运行(默认 127.0.0.1:18787,-p 覆盖端口)
./ccbuddy-server -p 9000
Latest

下载安装

从 GitHub Releases 获取最新构建,开箱即用 —— 所有链接始终指向 Latest,以后发新版这个页面也不用改。

macOS

Apple Silicon · dmg 安装包

Windows

x86_64 · 安装版 / 便携版

Linux

x86_64 · 无头服务端

另有 Hook 独立包(darwin aarch64 / x86_64、linux-x86_64、windows-x86_64)与全部历史版本,见 GitHub Releases。

Quick start

两分钟跑起来

克隆仓库 → 构建运行 → 设置页一键安装 Hooks,即可开始监控。

# 1. 克隆并进入项目
git clone https://github.com/xutopia77/ccbuddy.git
cd ccbuddy

# 2. 开发模式运行(需要 Rust 工具链)
npm install
npm run tauri dev

# 3. 首次使用:设置页 → 「一键安装 / 更新 Hooks」

Hook 优先使用本地文件,否则使用程序内嵌 hook(编译期嵌入),全程无需联网。数据全部留在本机:~/.ccbuddy/

Security

数据不出本机,密码不落明文

监控工具不该成为新的风险面。CCBuddy 从第一天就按这个标准设计。

🔒

Argon2id 哈希

访问密码只存 Argon2id 哈希(内存难解、抗 GPU 爆破),明文不落盘,配置文件被读走也无法还原。

🍪

Session Token

登录签发 HttpOnly Cookie,空闲 15 分钟 / 最长 15 天失效,登录态只存内存,重启即失效。

📵

零外发

无遥测、无上报、不联网。事件日志是本地纯文本 JSONL,随时可以审计或删除。

🏠

数据主权

所有数据都在你自己的机器上:事件流、配置、Claude Code 原生记录,删除即消失。

别再逐个终端翻了

一块面板,看清所有 Claude Code 会话。开源免费,MIT 协议。