Beeplight
English 安装

免费开源 · Mac 菜单栏应用

Claude 一举手，
你就知道。

Beeplight 是 Mac 菜单栏里的一盏状态灯，替你照看每一个 Claude Code 会话和 agent。任务交出去，你去忙别的：Claude 等你拍板，或者活干完了，灯一亮你就知道；点一下，回到对应窗口。

$ brew install derek920/tap/beeplight
下载 Mac 版

macOS 14 及以上 · Apple 芯片与 Intel 通用 · Apache-2.0

三盏灯，零配置。

每秒 3 次，扫过每一个会话，归进三种状态。数据取自 Claude Code 自己的会话文件：不装 hook，不改设置，装上就能用。

Doing

Claude 正在干活

菜单栏亮起蓝色转圈和数量。正等着后台任务跑完的，也算在这里。

Waiting

Claude 需要你

要你授权、要你回答、弹了对话框，都在这里。等过 3 分钟，举手就变红。

Done

这一轮结束了

每一轮都有结论：做成了，还是没做成，API 出错、被打断也算在内。新完成的一直标着，看过才消。

不用挨个窗口翻，
一眼全看清。

点一下，直达现场

任务在 iTerm2、Terminal 的哪个标签页，Claude 桌面端的哪个会话，哪个编辑器窗口，点一下就到。后台会话直接接上；关掉的会话，用 claude --resume 原样续上。

  • iTerm2精确到标签页
  • Terminal精确到标签页
  • Claude 桌面端精确到会话
  • VS Code · Cursor · Trae项目窗口
  • claude --bg直接接上
  • 关掉的会话原样续上

标题跟着进度走

标题写的是它此刻在做的事，不是你最初随手敲的那句。每轮结束，再给一句成败结论。

额度，心中有数

5 小时与本周额度、用得多快、每个会话花了多少，一目了然；快见底时，提前提醒你。详情 ›

做完的，等你看过

刚做完的任务像未读消息一样一直标着。打开它，或者切到它的终端标签页，标记才消。

刘海里的灵动岛

从 MacBook 的刘海里长出来；没有刘海的屏幕上，化作一颗随手可拖的胶囊。悬停展开列表，有事弹出提醒；也可以平时隐身，有事才现身。

时间线，有迹可循

每个任务一条彩色时间线：干了多久、等了你多久、今天一共做了多少，都记着。

通知，一点即达

需要你、做完了、失败了，都会通知你。点通知上的按钮，直接跳到任务。

  • 子 agent 挂在启动它的会话下面，层次分明。
  • 用 claude --bg 启动的后台会话，一样看得见。
  • 中英双语界面，连任务标题也随语言切换。
  • localhost:7333 上还有一块网页看板，数据同样实时。
  • CPU 占用：整台 Mac、Claude Code、Beeplight 自己各占多少，面板和看板底部一行看清。
  • 每一项运行参数都在「设置 → 高级」，默认值和说明一并列出。

额度花在哪，一清二楚。

点开额度卡片：涨得多快，照这个速度到重置时会用到多少，又被谁用掉了，一页看完。

  • 额度曲线Anthropic 服务器的真实读数连成一条线；一条虚线，按当前速度推到重置。
  • 粗细由你5 小时窗口按 10 分钟、30 分钟或 1 小时看，本周按 1 小时、6 小时或 1 天看。指向任意一根柱子，这段时间用在了哪，立刻知道。
  • 去向分明按模型、Token 类型、项目、会话层层拆开；点会话，直接跳过去。网页看板和配对的手机上，同样能看。

你的菜单栏，你做主。

五套预设，六种菜单栏样式，还有一个闲下来陪着你的小家伙。

菜单栏样式

示例：1 个等你处理、2 个进行中、1 个新完成。

  • 胶囊计数
  • 红绿灯
  • 雷达环
  • 能量条
  • 终端文字
  • 单点

一键预设

主题、菜单栏样式、灵动岛、动效，一键配齐。

  • 原生 macOS
  • 赛博霓虹
  • W1 D2 ✓1▌黑客终端
  • 全息 HUD
  • 极简

闲下来，有它陪你

没有任务在跑、在等你，也没有新完成时，菜单栏和灵动岛换上你选的小家伙。它的气色跟着剩余额度走：额度充足，一身绿，精神抖擞；用过一半，转成琥珀色；快要见底，红了脸，昏昏欲睡。机器人兴致来了，还会甩甩天线。

  • 数字机器人
  • 数字狗
  • 数字猫
  • 终端猫
  • 终端狗

想自己做一个？主题、预设、形象都是 JSON 数据包，改个文件就能加，一行代码都不用写。 数据包格式

手机放一旁，抬眼就知道。

打开「手机访问」，手机就是 Mac 身边的状态屏：时间、进展、额度、等你处理的任务，一屏尽收。光随状态流转，小家伙在一旁陪你。

  • 扫码配对，只在你的局域网内访问。
  • 无需安装，添加到主屏幕即可。
  • 点任务，在 Mac 上打开；点额度，查看详情。
  • iPhone、Android 都能用，横竖屏皆宜。
即将推出

Beeplight iPhone 版

即将登陆 App Store。主屏与锁屏小组件，加上实时活动：进行中和等你的任务，灵动岛里一眼可见。

本地运行，
数据留在本地。

没有账号，没有遥测

不用注册，不做统计，也不检查更新。服务只监听 127.0.0.1；手机访问默认关闭，你开了才有。

只看，不碰

Beeplight 只读 ~/.claude 下 Claude Code 的文件和进程列表，不写一个字，不装一个 hook。它自己记下的标题、判定和时间线，最多留 30 天，「设置 → 高级」里随时清理。

离开 Mac 的，只有一样

为了写标题、下结论，它会把每个会话最近的一段对话，经你自己的 claude 登录发给 Claude Haiku。和平常的 Claude Code 请求一样，计入你的用量。

多台 Mac，一块看板

自建一个中转服务，每台 Mac 都能看到其他 Mac 上的任务。摘要以 AES-256-GCM 端到端加密，中转服务看不到标题，也看不到状态。

一行命令，即刻装好。

brew install derek920/tap/beeplight
open -a Beeplight

日后更新，一句 brew upgrade。

运行环境

macOS 14 Sonoma 及以上，装好并登录 Claude Code。

首次使用

macOS 会请你允许通知；第一次跳到终端标签页时，再请你允许 Beeplight 控制 iTerm2 或 Terminal。

常见问题

Beeplight 收费吗？

不收费。Mac 应用、网页看板和中转服务都免费，以 Apache License 2.0 开源。即将推出的 iPhone 应用，会在 App Store 付费提供。

它会改动我的 Claude Code 配置吗？

不会。Beeplight 只读 Claude Code 自己的会话文件和对话记录：不装 hook，不改设置，退出后不留痕迹。

它会消耗我的 Claude 用量吗？

会，但很少。标题和判定由 Claude Haiku 经你自己的 claude 登录生成：一轮开始一次，结束一次，长任务期间每 5 分钟一次。用 Claude 订阅时计入套餐额度；用 API key 时，每次约 0.001 美元。

它会拖慢我的 Mac 吗？

眼见为实：面板底部的 CPU 一行，把整台 Mac、Claude Code 和 Beeplight 自己并排列出。Beeplight 只读 Claude Code 文件里新写入的部分，app 只重画变了的地方，小家伙在两个动作之间安安静静。

能调整它的行为吗？

能。「设置 → 高级」列出每一项运行参数和默认值：生成标题的模型、结束的任务在看板上留多久、多久查一次额度、历史保留多久……大多数改动一秒内生效。不用 app，就写进 config.json。

能跳转到哪些终端和编辑器？

iTerm2 和 Terminal 精确到标签页，Claude 桌面端精确到会话，VS Code、Cursor、Trae 等编辑器跳到项目窗口。tmux 里的会话，暂时还定位不到。

能看到其他 Mac 上的会话吗？

可以，借助你自己运行的中转服务。每台 Mac 先加密摘要再上传，密钥只在你自己的设备上；文件路径、提示词、对话和用量，一概不共享。

它和刘海类应用、用量统计工具有什么不同？

Beeplight 把三件事放在一起：每个会话的状态，无论它跑在终端、Claude 桌面端还是编辑器里；你的额度用量；以及把这两样装进一屏的手机状态屏。不用装 hook，而且开源。

Claude Code 升级后它会失效吗？

有可能。Beeplight 依赖 Claude Code 的内部会话文件，版本之间可能会变；变了，Beeplight 就跟着更新。

Beeplight 是 Anthropic 做的吗？

不是。Beeplight 是独立项目，与 Anthropic 无关，也未经其认可。

任务交出去，放心忙别的。

有事，灯会亮。

$ brew install derek920/tap/beeplight
在 GitHub 上查看