cctop 会话面板
在 macOS 菜单栏集中查看 AI 编程会话，并用快捷键回到需要处理的会话。
- 源仓库
- st0012/cctop
- Star 数
- ★ 154
- 最近更新
- 9 天前
- License
- MIT
- 主语言
- Swift
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时运行多个 Claude Code 或 Codex 会话、需要快速找出哪个会话正在等待输入的开发者。
- 不适合
- 需要 Windows 或 Linux 原生应用的用户
- 希望通过一个面板精确跳转到 IDE 窗口的用户
- 源码审查
- 73/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
cctop 是一款适用于 macOS 13 及以上版本的菜单栏应用，用于汇总 Claude Code、Codex、opencode 和 pi 的本地会话状态。各工具通过插件、扩展或事件钩子调用原生辅助程序 `cctop-hook`，由它将每个会话写成 `~/.cctop/sessions/` 中的 JSON 文件；应用监视这些文件并显示会话状态。用户可以从会话卡片或 Navigate 模式跳转到支持的终端窗口、标签页、分屏或桌面线程，也可以打开项目目录或激活相应应用。它还提供最近项目和已结束会话 worktree 清理功能，并在提供清理操作前检查 Git 状态。数据保存在本机；签名版本只通过网络检查并下载 Sparkle 更新。
安装并启动 macOS 应用后，在 Settings 中连接工具：Claude Code / Claude Desktop 使用插件和事件钩子，Codex CLI / Desktop 使用事件钩子，opencode 使用插件，pi 使用扩展。各集成在会话事件发生时调用 cctop-hook，将会话状态等信息写入 ~/.cctop/sessions/ 下的 JSON 文件；cctop 监视该目录并在菜单栏面板显示工作中、空闲或等待处理的会话。点击卡片或使用 Navigate 模式可跳转到可识别的终端目标；对于编辑器，应用会聚焦窗口并使用工作区文件（如果存在）；无法定位精确目标时则激活应用或在 Finder 中打开项目。应用还维护最近项目，并查找磁盘上残留的已结束 agent worktree，在检查 Git 安全状态后提供相应删除选项。
- 同时运行多个 Claude Code 或 Codex 会话、需要快速找出哪个会话正在等待输入的开发者。
- 在 iTerm2、Ghostty、tmux 或其他受支持终端中启动 agent 会话、希望从菜单栏跳回对应窗口或分屏的用户。
- 使用 Claude Code、Codex、opencode 或 pi，并希望在一个本地面板查看这些工具会话状态的个人开发者。
- 经常使用 Git worktree 运行 CLI agent、需要检查并清理已结束会话留下的 worktree 的用户。
- 希望查看近期项目并快速重新打开项目目录、而不必翻找旧终端的开发者。
如何安装或部署这个 Agent？
需要 macOS 13 或更高版本。下载适合芯片的已签名 DMG，或通过 Homebrew 安装：
brew install --cask st0012/cctop/cctop也可以下载 Apple Silicon 或 Intel 构建：
Apple Silicon: https://github.com/st0012/cctop/releases/latest/download/cctop-macOS-arm64.dmg
Intel: https://github.com/st0012/cctop/releases/latest/download/cctop-macOS-x86_64.dmg安装后打开应用，再进入 Settings 连接工具。Claude Code / Claude Desktop 的插件安装命令为：
claude plugin marketplace add st0012/cctop
claude plugin install cctopopencode、pi 和 Codex 的连接可分别在 Settings 中点击 Install Plugin 或 Install Hooks。Codex 安装钩子后，需启动一次 Codex CLI 会话并选择 Trust all and continue；Codex Desktop 共用此信任状态。源码构建需要 Xcode 16+ 和 macOS 13+。
如何使用这个 Agent？
打开 cctop 的 Settings，在 Tools 中安装已检测到的客户端集成，在 Integrations 中安装配套应用集成。安装插件或钩子后，重启正在运行的会话；之后新会话会自动跟踪，无需逐项目配置。打开菜单栏面板查看状态，点击会话卡片跳转；也可按全局快捷键进入 Navigate 模式，再按数字键 1–9 选择会话。右键可隐藏会话，但只要其本地记录仍存在，就无法再次显示。若使用 Codex 钩子，首次还需在 Codex CLI 中信任它们。
这个 Agent 有哪些优点和局限？
- Claude Code、Codex、opencode 和 pi 的会话状态汇总在一个菜单栏面板中。
- 支持多种终端的精确窗口、标签页或分屏跳转，并提供数字快捷键 Navigate 模式。
- 会话记录以本地 JSON 保存；项目明确说明没有分析、遥测或会话上传。
- 清理已结束会话留下的 worktree 前会检查 Git 状态，并提供对应删除操作。
- 需要 macOS 13+；README 没有记录 Windows 或 Linux 版本。
- 不同集成需要分别安装插件、扩展或钩子；Codex 还要求用户信任钩子。
- 精确跳转能力依赖具体终端和配置；部分环境需要 macOS Automation 权限，不满足条件时会退回激活应用。
- 编辑器集成打开或聚焦项目窗口，而不是文档所列的精确会话级窗口定位。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| cctop 会话面板 当前 | 73 · 存在缺口 | 桌面应用免费 | ★ 154 | 9 天前 | Swift | Codex · Claude Code |
| Alook AI 公司协作层 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.3k | 今天 | TypeScript | Codex · Claude Code |
| Hermes Studio | 44 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 11k | 今天 | TypeScript | Codex · Claude Code · OpenAI API |
| Wondel.ai Agent技能库 | 40 · 缺口较多 | Agent 插件 / 技能免费 | ★ 2.4k | 1 个月前 | Shell | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明会在本机以JSON保存会话状态，不上传会话，并说明更新检查和下载会联网；展示了各工具通过本地hook写入、应用读取的流程。隐藏会话会先询问，清理功能会检查Git状态，卸载说明也列出移除步骤，因此最小权限、确认和恢复支持有实际依据。扣分原因：会话文件含提示上下文等敏感信息且是明文，未见加密或访问控制说明；自动化权限和Codex hook信任步骤有说明，但安装/跳转仍可能触发系统级效果；来源署名有许可证版权名，但发布者身份未验证，也未见清晰维护责任或安全依赖审查政策。
README对工具集成、会话文件、跳转目标和回退行为作了较完整描述；CI配置包含Swift lint、构建与测试、插件测试、hook契约检查及helper smoke test，依赖版本也有锁定的GitHub Action提交。扣分原因：静态材料不能证明这些工作流实际通过；失败诊断主要是FAQ中的检查步骤，未呈现应用运行时错误处理或完整错误消息策略；SwiftLint和check-jsonschema等安装步骤依赖外部包源。
受众和常见场景具体覆盖多种编码工具、编辑器、终端、多会话导航、最近项目和worktree清理。README明确列出精确跳转所需权限、工具版本和回退方式，也说明不同客户端的安装和信任差异。扣分原因：适用范围集中在macOS 13+，且个别跳转依赖特定应用配置或版本；触发方式描述为各工具事件hook/plugin，但未在所给材料中逐一列出事件范围及触发边界。
README按功能、兼容性、安装、隐私、FAQ和参考资料组织，含安装、构建、卸载命令，并具体记录已知限制、平台要求和旧版Intel更新问题；MIT许可证正文完整。扣分原因：所给材料没有CHANGELOG或明确版本策略，README仅链接最新release；维护责任主要只能从仓库名和许可证版权名推测，未见维护团队、支持渠道或响应承诺；命名在不同集成和产品描述中虽可理解，但没有独立稳定性政策。
产品输出是可扫描的会话状态、编号热键导航、项目打开/应用激活和清理列表，面向明确的多会话切换问题；README给出工具覆盖和具体跳转目标，足以支持其预期实用价值判断。扣分原因：成本收益主要由功能描述推断，材料没有资源占用或用户结果数据；集成需要安装插件/hook，并可能要求系统自动化权限或Codex信任操作。
README中的隐私、集成和工作流主张有具体本地路径、数据字段、命令及流程图支撑，CI文件也列明对应的静态检查和测试命令，许可证可直接核对。扣分原因：文档与CI配置来自同一仓库，属于有限的交叉佐证；发布签名、公证和无遥测等声明在给定材料中没有独立凭据；评分依据静态文件，未将文档主张当成已执行验证结果。
- 会话数据以明文JSON保存在本机，其中包括当前工具或提示上下文；请按本地敏感数据管理。
- 精准跳转能力因应用、版本、配置和系统权限而异；部分情况会退回到激活应用或打开项目文件夹。
- CI文件列出了测试和检查流程，但本评估没有执行它们，也无法据此确认实际通过状态。
常见问题
cctop 会把会话内容上传或发送到云端吗？
~/.cctop/sessions/。签名版本会联网检查并下载 Sparkle 更新。