bigarrow开源:给Claude Code和Codex一根“手指”,在Mac屏幕上画箭头指给你看

开发者franzenzenhofer开源了命令行工具bigarrow(项目名big-arrow-on-the-screen),并附带供Claude Code和Codex使用的skill。agent需要用户点击某个按钮时,可以调用它在所有窗口上方画出箭头和提示牌,而不是只在终端里打印一句话。项目采用MIT许可,仅支持macOS。

它要解决什么问题

README开头写道:agent能重构整个monorepo,但需要用户点一个按钮时,只会在用户没看的终端里打印“请在对话框中点击允许”。bigarrow要给它一根“手指”。

它是覆盖在所有显示器和所有桌面空间之上的一个透明窗口。点击可以穿透,键盘焦点不变,箭头会自行消失。README称,绘制本身不需要任何macOS权限。

设计特点

作者称,项目只有一个Swift二进制文件,无后台进程、无菜单栏图标、无账号、无遥测,并写道“检查了两遍,里面没有AI”。

定位目标的方式包括:

• --at X,Y(坐标)和 --rect(矩形区域);
• --mouse(鼠标位置);
• --window App[:title](窗口);
• --element Label --app App(按界面元素标签);
• --peekaboo(读取Peekaboo的输出作为目标来源)。

其中--element、--until-click和--app App:title需要辅助功能(Accessibility)权限。

箭头默认都会限时结束:point为8秒,start为300秒,--duration 0表示不限时。命令退出码约定为:0成功,2输入错误,3未找到目标,4缺少权限。

安装与skill

通过Homebrew安装:

brew install franzenzenhofer/tap/bigarrow
bigarrow install-skill

第二条命令会把skill分别装到Claude Code(~/.claude/skills)和Codex(~/.agents/skills)。从源码构建需要Xcode 16+和macOS 14+。

README称,skill的描述为182个token,指令为1,398个token(用Anthropic的token计数API、Claude Opus 5.5测得),另有1,008个token的窗格id和外观旗标按需加载。

发布方自测与已知限制

以下数据均来自README:

• 在CI runner上,脉动箭头占用CPU 1.4%;
• 有104项自动化测试,CI运行在macOS 15,并在macOS 26和27上也通过;
• 另有18项在干净runner上的行为检查。

在Chrome中,--element需要开启--force-renderer-accessibility(或打开VoiceOver)才能工作,README注明该结论于2026年10月验证;Electron应用可直接使用。

热度

README称,项目上线头两天获得近400个star,并称作者事先检查了26个同类工具,没有一个做这件事。

相关下载

• ChatGPT
• Claude

来源

• https://github.com/franzenzenhofer/big-arrow-on-the-screen