OrbCue

同时开着几个终端里的 AI 助手，窗口一多就很难看出谁在干活、谁在等你。 OrbCue 在 Windows 桌面上放一个小球：orb 是形态，cue 是该你出手了。工作时只显示数量，需要你处理时才提醒。 点开小球是按项目分组的列表，点条目上的返回箭头可以跳回对应终端。命令行是 orb。 - 不读取对话、提示词、命令或代码，也不替你操作这些工具 - 默认不联网；状态只保存在本机当前用户目录 - 支持的命令行工具： | 工具 | 命令 | | ------------ | -------------------- | | Claude Code | claude | | Grok Build | grok | | Codex | codex | | Cursor Agent | agent / cursor-agent | 以上指的都是 CLI 版本。 它做什么、不做什么 做 - 多个工具共用一个小球。数字是「正在工作的主会话 / 当前列表里的主会话」，例如 2/5 - 等待输入、等待授权或失败时，弹一次系统通知并播提示音；正常完成只播提示音，不弹通知 - 在「连接」页接上本机已经装好的工具：不替换可执行文件，确认前会列出将要改的文件 - 从列表跳回终端。用 orb run 在 Windows Terminal 里开出的专属标签，可以精确回到那个标签 不做 - 不读取对话记录、提示词、命令、代码、终端输出或凭据 - 不扫描进程列表去猜测工具是否在工作 - 不替换工具的可执行文件；连接失败也不会下载或重装任何东西 - 不监听网络端口，不上传任何数据 - 面板不展示对话摘要，只显示工具名、所属项目和状态 界面 点小球展开面板；再点一次或点面板右上角 × 收起。托盘菜单可以「打开 OrbCue」、隐藏或显示小球、退出。 | 页面 | 作用 | | ---- | ----------------------------------------------------------------------------------------- | | 小球 | 桌面常驻。数字是工作中 / 追踪中；? 表示有任务在等你，! 表示有失败。可拖到屏幕边缘贴成半圆 | | 动态 | 当前会话列表，按项目分组，可筛选全部 / 工作中 / 未工作 | | 审计 | 本次运行里最近的完成、失败、等待和关闭，最多 128 条，只在内存中，重启即清空 | | 连接 | 列出本机检测到的工具，确认后连接或断开 | | 设置 | 外观、提示音、系统通知、开机自启、快捷键、圆标、侧边收起，以及启动别名 | 外观主题有五套：原型、Fluent、Glyph、Braun、Glass，在「设置」里切换。 动态 每条会话显示工具名、项目和状态，没有对话内容。 - 已读：去掉等待提醒 - 清除：把卡住的条目从列表拿掉。只影响 OrbCue 的显示，不会向工具发命令；清掉之后这条不会再回来 - 返回箭头：跳回终端。用 orb run 开出的专属标签能精确回去（标签被拖出或合并过也有效）；自己手动开的终端只回到该窗口最近交互过的位置，窗口已经关掉时会提示失败，不会跳错地方 - 底栏「全部已读」「清除全部」对当前列表一次性操作 - 工具进程退出后，对应条目会自动消失 - 子任务计入所属的主任务，不单独占小球上的数字 要精确跳到某一个 Windows Terminal 标签：在「设置」里给启动方式起一个短命令（启动别名），然后用这个短命令在新标签里打开工具。没设别名时，在新开的 Windows Terminal 里运行 orb run grok（或 claude / codex 等）效果相同。第一次用之前需要先启动过一次 OrbCue，并新开终端。 连接 每一行是一个已检测到的工具，并标明在 Windows 还是 WSL。状态是「可连接」或「已连接」。 - 连接：先弹出将要改哪些文件，点「确认连接」才动手 - 断开：只移除 OrbCue 自己写入的内容，不会动你后来改过的其他设置 - 刷新：重新检测本机工具 - 从文件夹添加：官方安装路径里找不到时，选包含可执行文件的文件夹 同名工具在 Windows 和 WSL 各装了一份，就各占一行，分开连接。Cursor 编辑器本身不会被当成命令行工具。 连接页会查看：桌面程序能看到的 PATH、用户 PATH，以及常见安装目录（例如 %USERPROFILE%\.local\bin、Grok Build 的 %USERPROFILE%\.grok\bin、Cursor 命令行的 %LOCALAPPDATA%\cursor-agent）。装了 WSL 时再查看 WSL 里的 PATH（WSL 里能看到的 Windows 程序不重复计）。 设置 - 启动别名：给 orb run 起短命令，方便精确跳回 - 隐藏圆标：小球右上角不再显示 ? / ! - 收到侧边：默认打开。拖到屏幕边缘约一个球宽内，小球会贴成半圆，略透明、不显示数字；鼠标悬停会沿同一边滑出来，移开后再贴回去。出现 ? 或 ! 时会保持展开，直到你再把它拖到边上。关掉则只是普通拖动 - 完成 / 等待 / 失败提示音、系统通知 - 开机自启：登录 Windows 后自动打开 OrbCue - 全局快捷键：默认 Ctrl+Shift+Space 打开或收起面板 连接时改了什么 连接方式取决于工具是否提供 hook（工具自带的事件通知机制）： | 工具 | 连接方式 | 能报告的状态 | | ----------------------- | ----------------------------- | ---------------------------------------------- | | Claude Code、Grok Build | 在该工具自己的配置里登记 hook | 开始、等待、完成、失败、关闭 | | Cursor | 在该工具自己的配置里登记 hook | 开始、完成、失败、关闭；选择题不会标成「等待」 | | Codex | 在该工具自己的配置里登记 hook | 开始、等待、完成、关闭；打断和报错看不到 | 限制会写在连接页对应行上： - Cursor 命令行偶尔不会通知已经结束，任务会停在「工作中」，直到进程退出才消失 - Codex 用 Esc 或 Ctrl+C 打断当前回复时，不会通知 OrbCue，任务停在「工作中」；对话报错也不会显示为失败。在动态页点「清除」即可；退出 Codex 后任务也会从列表消失 - Claude Code / Codex 在授权框里点拒绝时，不会通知 OrbCue。小球会停在「等待授权」，直到它继续干活或这一轮结束；也可以在动态页点「清除」。Grok Build 点拒绝会马上回到工作中 - 首次修改 Claude Code / Codex / Cursor 的配置前，会保留一份备份（例如 settings.json.orbcue.bak） 隐私与数据 - 只在本机、当前用户范围内通信：Windows 用命名管道，WSL 里的命令行用 Unix socket；不监听任何网络端口 - 写入磁盘的只有：来源、任务 ID、状态、时间、已读标记、终端标记、项目路径。Windows 在 %LOCALAPPDATA%\OrbCue\state.json；WSL / Linux 命令行在 $XDG_STATE_HOME/orbcue/state.json（默认 ~/.local/state 下） - 任务摘要只在内存里短暂存在，不写盘；对话、提示词、命令一概不经手 - 重启后会恢复上述最小状态，但不会重播提醒；过期事件直接丢弃 - 判断工具进程是否退出时，只查询连接时记下的那一个进程，不扫描整个进程列表 - 提示音、界面或某个连接出问题，不影响状态服务本身；卡住的条目可以随时「清除」