QZYH123

OrbCue

Name: OrbCue
Author: QZYH123

Communication community

SOURCE https://github.com/QZYH123/OrbCue

Description

Desktop orb for Windows that cues you when Claude Code, Grok, Codex or Cursor Agent needs you. Working sessions show a count; waiting/failed sessions get a ? / ! plus a notification. Local-only, hook-based, no conversation reading.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

OrbCue — The orb that cues you when an agent needs you.

[![Latest](https://img.shields.io/github/v/release/QZYH123/OrbCue?label=latest)](https://github.com/QZYH123/OrbCue/releases/latest) [![License: MIT](https://img.shields.io/github/license/QZYH123/OrbCue)](LICENSE) [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D6?logo=windows&logoColor=white)](#系统要求) ![CLI](https://img.shields.io/badge/CLI-Claude%20%7C%20Codex%20%7C%20Cursor%20%7C%20Grok-555)

同时开着几个终端里的 AI 助手，窗口一多就很难看出谁在干活、谁在等你。

OrbCue 在 Windows 桌面上放一个小球：orb 是形态，cue 是该你出手了。**工作时只显示数量，需要你处理时才提醒。** 点开小球是按项目分组的列表，点条目上的返回箭头可以跳回对应终端。命令行是 `orb`。

工作时只显示数量，需要处理时出现问号，点开按项目分组的列表，并切换五套外观

当前 **0.2.5**，桌面程序只在 Windows 上提供。安装包见 [GitHub Releases](https://github.com/QZYH123/OrbCue/releases/latest)。

不读取对话、提示词、命令或代码，也不替你操作这些工具
默认不联网；状态只保存在本机当前用户目录
支持的命令行工具：

工具	命令
Claude Code	`claude`
Grok Build	`grok`
Codex	`codex`
Cursor Agent	`agent` / `cursor-agent`

以上指的都是 CLI 版本。

它做什么、不做什么

做

多个工具共用一个小球。数字是「正在工作的主会话 / 当前列表里的主会话」，例如 2/5
等待输入、等待授权或失败时，弹一次系统通知并播提示音；正常完成只播提示音，不弹通知
在「连接」页接上本机已经装好的工具：不替换可执行文件，确认前会列出将要改的文件
从列表跳回终端。用 orb run 在 Windows Terminal 里开出的专属标签，可以精确回到那个标签

不做

不读取对话记录、提示词、命令、代码、终端输出或凭据
不扫描进程列表去猜测工具是否在工作
不替换工具的可执行文件；连接失败也不会下载或重装任何东西
不监听网络端口，不上传任何数据
面板不展示对话摘要，只显示工具名、所属项目和状态

系统要求

Windows 10 / 11（x64）。小球和面板只在 Windows 上运行
WSL 可选。装了之后，WSL 里的工具和 Windows 上的会出现在同一个小球里；没装不影响使用
精确跳到某一个标签只适用于 Windows Terminal，需用 orb run 或启动别名开出专属标签。窗口级跳回适用于 Windows Terminal、cmd / PowerShell 独立窗口、Alacritty、WezTerm、Git Bash（mintty）和 Tabby；VS Code、Cursor 等编辑器内置终端不行
macOS 与 Linux 桌面暂未正式支持