Skipper:一款可用于同时运行多个Claude Code会话的本地控制面板。
一个免费的开源控制面板,可追踪Claude Code会话、子代理和循环机制,在需要权限时向用户发送提醒,还能让用户通过浏览器或手机操控代理。
一旦 Claude Code 不再只是单次会话的使用方式,终端界面布局就会发生变化。此时会有四到五个会话同时运行:一个负责重构后端,一个在 git 工作树中编写测试,还有一个 /loop 状态处于休眠状态直到 CI 流水线完成,还有一个会话则启动了三个后台子代理并正在等待它们的反馈。在某种模式出现之前,这一切看起来都很高效。但二十分钟后回到终端时,却发现那个会话一直都在那里,不断询问是否允许执行某个命令。这意味着,因为注意力集中在另一个窗口上而需要一次按键操作,这个 AI 编码代理就有二十分钟处于空闲状态。
并行运行多个代理确实很强大,但终端从来就不是为管理它们而设计的。关键问题在于当前哪个会话需要人工干预。由于没有现有工具能解决这个问题,于是便有了 Skipper 的诞生。
Skipper 是什么
Skipper 是 Claude Code 的任务控制中心。它是一个免费的本地开源控制面板,能够实时显示机器上的所有会话、子智能体、/loop 功能以及待办事项列表,让你无需在多个终端之间切换即可对它们进行操作。只需一条命令即可启动它:
npx github:bilol-makhmudov/skipper
打开 http://localhost:4317,每个会话都会显示清晰的状态:
- 需要权限: Claude 正在等待使用某工具的批准。
- 需要您操作: 当前轮次已结束,下一个消息由您处理。
- 正在运行: 会话正在执行中,工具正在使用中,并显示该轮次已过去的时间。
- 处于休眠状态: 有
/loop正在等待下次唤醒,会显示倒计时及暂停原因。
需要关注的会话会浮显在顶部。标签页标题会显示正在等待的会话数量,而图标颜色会变为琥珀色或红色,这样即使标签页被固定,也能及时发出提示。
监控子智能体、待办列表和循环
除了会话状态外,控制面板还会显示每个智能体当前正在执行的任务:
- 实时的待办事项和任务列表,以及包含负责人和阻碍因素的代理团队任务列表。
- 后台子代理的信息,包括其名称、模型、工作树分支以及上次操作的时间。
/loop计时器,可显示下一次唤醒时间以及暂停的原因。- 工作流、拉取请求和生成物,一键即可访问。
- 记录您离开期间所有会话中发生的所有事件。
- 按日、项目和模型显示令牌使用情况,包括子代理的数据,并可导出为CSV格式。
权限提示通知
这正是Skipper存在的意义。只需一条命令即可设置:
skipper hooks install
它在设置中新增了两个官方的 Claude Code 钩子:Notification 和 Stop。此后,每当会话请求权限时,就会响起提示音并显示桌面通知,该通知会一直存在直到被点击,同时显示需要批准的准确命令。当一轮对话处理完成后,则会发出较轻的提示音。
这个钩子几乎不起任何作用。它只是向本地的事件文件追加一行内容后就退出,因此不会拖慢会话速度或导致会话中断,而这比任何功能都更重要。那些不想保持浏览器标签页打开的人可以运行 skipper hooks native on 来直接发送系统通知。
主动控制,而非仅旁观
- 向会话发送消息。 对于在终端中打开的会话,消息会直接添加到该对话中。已结束的会话会在后台从其原始工作目录重新启动。
--read-only 参数即可关闭所有写入操作。借助语音助手在手机上使用 Claude Code
当控制面板能够正常使用时,接下来的需求就是在远离办公桌的地方也能使用它,比如在泡茶时想确认迁移是否已完成。为此,Skipper 开发了一款基于 Flutter 的 iPhone 应用。通过扫描控制面板上的二维码即可配对,该应用会显示相同的会话、活动和对话内容。其中最常被使用的功能就是语音助手。
只需轻触麦克风,问题“有什么需要我处理?”就会得到语音回复:哪些会话正在等待授权、哪些已经完成、哪些仍在运行。后续操作无需重复输入会话名称即可进行。说出“让结账会话在本次测试后停止”后,助手会重复该指令并等待确认,只有在得到肯定答复前不会发送任何内容。它支持英语和乌兹别克语。在免提模式下,它会持续监听,一旦用户开始说话就会立即停止发声。
实际上,这个助手就是 Claude Code 本身,以无界面模式运行,通过 MCP 提供了一小套只读的 Skipper 工具,还有一项用于发送消息的工具。它能看到 Skipper 所能看到的一切内容,未经确认不会做任何更改。
Claude Code 如何在磁盘上存储会话
令人惊喜的是,Claude Code 已经在 ~/.claude 目录下生成了控制面板所需的所有内容:
~/.claude/projects/*/<session>.jsonl用于存储会话记录:提示词、回复、待办列表、子智能体、循环逻辑以及拉取请求。~/.claude/sessions/*.json用于记录哪些会话正在运行,以及每个会话是处于忙碌状态还是空闲状态。~/.claude/tasks和~/.claude/teams用于存储任务列表和智能体团队信息。
转录内容会从上次处理完毕的位置开始逐步读取,因此即便处理历史记录非常庞大也能保持响应迅速。当文件监控机制触发时,变化会通过 Server-Sent Events 传输到浏览器,因此无需轮询,也不存在刷新按钮。后端仅为纯 Node.js,没有运行时依赖;前端则是普通的 HTML、CSS 和 JavaScript,无需构建步骤或框架。
以本地优先且私密为核心
会话中包含代码和提示语,因此用于读取这些内容的工具在安全性方面必须十分严谨。
- 无外部数据传输。该工具不包含任何遥测功能、CDN 服务或外部调用。只有电话上的可选语音回复会通过 Microsoft 的语音服务联网,而语音转文本的功能则由机器上的 Whisper 来处理。
claude CLI以参数列表的形式接收消息,绝不会通过shell传递。安装方法
npm install -g github:bilol-makhmudov/skipper
skipper hooks install # chime and notify on permission prompts
skipper service install # run in the background, start at login
添加 --demo --open 可以打开包含示例会话的导览。需要 Node.js 20 或更高版本,支持 macOS、Linux 和 Windows 系统。
常见问题
- 每个会话都有对应的视图吗? Skipper 会自动在
~/.claude下查找会话,新会话一旦启动就会显示出来。 - 子代理、代理团队和工作树也被涵盖吗? 是的。后台子代理、带有负责人的团队任务列表以及工作树分支都会被列出。
- 需要权限时会发出提示音吗? 在执行
skipper hooks install后,权限请求、问题以及对话结束都会触发提示音和桌面警报。
未来的规划包括加密电话连接、Android版本以及更多便捷的会话操作功能。