AB
AiBoss
project

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)信息,实际使用中可能涉及系统授权,具体以项目文档为准。
  • 工具只做指向与提示,不执行点击、输入或截屏,因此不能替代自动化操作本身。
  • 提示卡中的密钥虽做了遮蔽与剪贴板清理,但仍属于在屏幕上展示敏感信息的方案,使用者应自行评估场景风险。