cc-view

跨终端 Claude Code 会话状态总览 · macOS menubar

Tauri 2RustVue 3macOSClaude Code
⬇ 下载 源代码

并行开多个 Claude Code 终端会话时，状态散落在各 tab / 窗口——哪个在干活、哪个等你回复 / 权限、哪个已经 idle，得逐个切窗口看。cc-view 把所有会话聚合到 menubar 一个图标 + ⌥Space 命令面板，点会话直接跳到正确的终端 tab，不用切窗口就能掌握全部会话、快速跳到要处理的那个。

核心功能

  • 🎛️ 命令面板（⌥Space） — 全局快捷键呼出居中 overlay，搜索 / 聚焦跳终端 / 搁置 / 归档 / 复制 ID，失焦自动收起；列显终端名 / token / 按钮均可独立开关
  • 🎯 精确切终端 tab — 点会话直接跳正确的 tab / window：iTerm2 / Terminal / Otty 按 TTY 匹配，Ghostty / cmux 按 OSC 7 marker，其余 app 级 activate
  • 📌 常驻模式 — 精简面板贴桌面常驻，透明度 + 宽度可调（拖完持久化），A 极简 / B 精简两种布局，待介入会话状态色脉动提醒 + 未读红点
  • 📊 Token 统计 — 每行累计 token（输入↑ / 输出↓），点详情看上下文增长曲线 + 按回合消耗明细，自动检测 compact；单位 k / M 或 万 / 亿 可切
  • 🎨 外观主题 — 浅色 / 深色手动切（默认浅色，不跟随系统），毛玻璃优化为 UnderWindowBackground，深色下文字清晰不糊
  • 🔔 menubar 聚合 + 系统通知 — 图标 tooltip「N 等我 · M 工作 / 等权限 / 等回答」，需介入时染橙 + 红圆 badge，按会话弹系统通知
  • 🗂️ 搁置 & 归档 — 搁置不催促不通知，会话有新状态自动取消搁置冒泡回顶；归档持久化可恢复
  • 💤 闲置降级 — 等输入超 30min 自动灰显 + 标「闲置」，全闲置项目整组下沉，不抢注意力
  • 🌐 国际化 — 简中 / 英语自动检测系统语言，偏好设置可手动切，menubar / tooltip / 通知全本地化
  • ⚙️ 偏好设置 & 自动更新 — VSCode 风格设置面板，基于 tauri-plugin-updater 的自动检查更新；GitHub 为主、Gitee 国内兜底双源

安装

  1. 点击上方「⬇ 下载」进入 GitHub Releases，按 CPU 架构选——Apple Silicon（M 系列）用 aarch64.dmg，Intel 用 x86_64.dmg
  2. 打开 dmg，拖 cc-view 到 Applications
  3. 启动后 menubar 出现图标，⌥Space 呼出命令面板

DMG 安装首次打开会提示「Apple 无法验证」（个人开源项目未做 Apple 公证）：系统设置 → 隐私与安全性 → 点「仍要打开」即可。cc-view 启动后会自动清除 quarantine 标记（v0.5.4+），后续启动不再弹；也可手动 xattr -dr com.apple.quarantine /Applications/cc-view.app。

要求：macOS 13+，Apple Silicon 或 Intel。首次运行需在系统设置授权通知 + 辅助功能 + 自动化（控制终端 app）。

技术栈

Tauri 2（Rust）+ Vue 3 + TypeScript。后端每 3s 采集多路数据源（~/.claude/sessions/、roster / agent 列表、claude agents --json、JSONL 尾部文本）→ 状态机 reduce → 通知 → hash 去重 → emit sessions 事件；前端 Vue 监听渲染。

MIT License。