big-arrow-on-the-screen - 让 AI 代理在屏幕上画出大箭头和提示卡
big-arrow-on-the-screen(bigarrow)是 macOS 上的命令行工具,也是 Claude Code 与 Codex 的技能,可在所有窗口之上绘制箭头与提示牌,点击可穿透、键盘焦点不变,箭头会自动消失。项目采用 MIT 许可,由 franzenzenhofer 维护,截至 2026-10-26 获 820 星标。
big-arrow-on-the-screen(命令行名 bigarrow)是一个 macOS 命令行工具,同时提供 Claude Code 与 Codex 的技能(skill)。按项目自述,它会在所有窗口之上画出一支箭头和一块提示牌,用来告诉屏幕前的人「点这里」;鼠标点击会穿透覆盖层,键盘焦点保持在原处,箭头到时间会自行移除。它面向的场景是:AI 代理已经能完成大部分自动化工作,但总有一些步骤必须由人来点——权限弹窗、OAuth 同意、二次验证、支付确认。代理找得到按钮,却不能或不该替人按下,于是它只能「指」。适合使用 AI 编码代理的 macOS 用户,以及需要远程指导他人操作、录制演示或撰写图文文档的人。
维护者与状态
项目由 franzenzenhofer 维护,仓库创建于 2026-10-08,最后提交时间为 2026-10-26。最新正式版本为 v0.5.1,发布于 2026-10-26。截至 2026-10-26,仓库获得 820 个星标。项目采用 MIT 许可证。
主要能力
以下能力均据项目 README 自述,本文未做实际运行验证。
- 按元素或坐标指向:可用
--element加--app按控件标签定位,也可用--at X,Y按全局坐标定位,或用--rect、--mouse、--window App[:title]指定区域与窗口。README 称坐标采用全局左上角逻辑点。 - 样式可调:支持箭头方向(
--from)、颜色、边框、尺寸、形状(直线、锯齿等)以及 ring、box 等样式,并可选择是否显示关闭按钮。 - 提示牌与复制按钮:提示文字中的
{{value}}会渲染成复制按钮,点击即可复制该值,适合让用户粘贴验证码、PIN 或链接。 - 提示卡(cue card):
bigarrow card可弹出带复制按钮的浮动卡片,支持--field、--secret、--link、--button、--ask、--choice等参数;README 称卡片内含 13 种行类型,并附有 20 个用例文件。 - 等待与回传:
bigarrow wait会等待用户操作,并以 JSON 形式把结果返回给代理;用户完成回答后退出码为 0,若先关闭卡片则为 1。 - 密钥处理:据 README,
--secret只从pass:、keychain:、op:、env:、file:读取,不从命令行读取;默认以圆点遮蔽,复制后 30 秒从剪贴板清除,且不会出现在返回结果中。 - 自动清理:箭头可设置时限(
point默认 8 秒,start默认 300 秒,0表示不限),也可用stop或stop --all主动移除;README 称绘制箭头的代理进程结束时箭头也会随之结束。 - 语音与导出:
--say可朗读提示文字,--png可直接渲染为图片,--dry-run --json可先查看将要指向的位置。
项目自述明确划定了边界:它不是屏幕标注工具、不是自动点击机器人、不是截图工具,也不是密码管理器;它从不点击、不输入、不截屏,只负责「指」和「举牌」。
使用入口
仓库地址:big-arrow-on-the-screen。
据 README,安装方式为 Homebrew:
brew install franzenzenhofer/tap/bigarrow bigarrow install-skill
其中 install-skill 会把技能安装到 Claude Code 与 Codex 的技能目录。也可从源码构建:
swift build -c release
README 称构建需要 Command Line Tools 或 Xcode、Swift 6,以及 macOS 14 及以上版本,产物位于 .build/release/bigarrow。README 给出的最简调用示例为:
bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"
许可与限制
项目采用 MIT 许可证。使用前需要注意的边界条件(据项目自述):
- 仅支持 macOS,README 写明需要 macOS 14 及以上版本;Windows 与 Linux 用户需另寻方案。
- README 称绘制本身不需要任何 macOS 权限,但按元素标签定位依赖辅助功能(Accessibility)信息,实际使用中可能涉及系统授权,具体以项目文档为准。
- 工具只做指向与提示,不执行点击、输入或截屏,因此不能替代自动化操作本身。
- 提示卡中的密钥虽做了遮蔽与剪贴板清理,但仍属于在屏幕上展示敏感信息的方案,使用者应自行评估场景风险。