Repolode
franzenzenhofer

franzenzenhofer/big-arrow-on-the-screen

一款 macOS 命令行工具兼 Claude Code、Codex 技能,可在屏幕上绘制大箭头和文字标牌,帮助指引用户点击目标。

Star
784
Fork
24
未关闭 Issue
4
最近提交
前天

这是什么?

bigarrow 是一款用 Swift 编写的 macOS 命令行工具,可在所有窗口之上绘制带文字标牌的大箭头,覆盖多显示器和所有桌面空间。箭头允许鼠标点击穿透,不会抢走键盘焦点,并会在超时、驱动它的代理进程退出或用户手动停止后自动消失。

它主要用于让 AI 代理指引用户去操作屏幕上的内容,例如权限弹窗、需要点击的按钮,或代理无法自行完成的双因素验证步骤。目标可以用坐标、窗口或应用名称指定,也可以通过辅助功能(Accessibility)API 按界面元素标签查找。工具本身不会点击、输入或截取屏幕。

它是一个不依赖守护进程、菜单栏图标或账户的单一可执行文件,可通过 Homebrew 安装,并提供为 Claude Code 和 Codex 安装技能说明的命令。箭头支持多种形状、样式和颜色,标牌中的数值还可以生成一键复制按钮。

核心功能

  • 01在所有窗口和桌面空间之上绘制带标牌的箭头、圆环和方框。
  • 02鼠标点击穿透覆盖层,且不会夺取键盘焦点。
  • 03可通过坐标、窗口或应用名称,或辅助功能中的元素标签指定目标。
  • 04箭头可按时长、驱动进程退出或停止命令自动结束。
  • 05标牌中的数值可生成复制按钮,并支持 --say 语音朗读。
  • 06支持 JSON 输出和明确的退出码,便于脚本调用。

适用场景

  • 代理需要用户授予权限时,告诉用户该点击哪个按钮。
  • 指引用户完成双因素验证、验证码或支付等代理不应代劳的步骤。
  • 逐步带领他人操作某个应用界面,或在屏幕共享时协助家人。
  • 录制演示视频或生成带标注截图时高亮界面元素。

快速上手

  1. 1

    通过 Homebrew 安装

    brew install franzenzenhofer/tap/bigarrow
  2. 2

    为 Claude Code 和 Codex 安装技能

    bigarrow install-skill
  3. 3

    用箭头指向某个界面元素

    bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"

使用前须知

  • 仅支持 macOS,从源码构建需要 macOS 14 或更高版本。
  • 从源码构建需要 Xcode 16 或更高版本。
  • 它只负责指示,不会点击、输入或截取屏幕。

标签

常见问题

big-arrow-on-the-screen 是什么?
一款 macOS 命令行工具兼 Claude Code、Codex 技能,可在屏幕上绘制大箭头和文字标牌,帮助指引用户点击目标。 bigarrow 是一款用 Swift 编写的 macOS 命令行工具,可在所有窗口之上绘制带文字标牌的大箭头,覆盖多显示器和所有桌面空间。箭头允许鼠标点击穿透,不会抢走键盘焦点,并会在超时、驱动它的代理进程退出或用户手动停止后自动消失。
big-arrow-on-the-screen 可以免费使用吗?用的什么许可证?
big-arrow-on-the-screen 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
big-arrow-on-the-screen 还在维护吗?
活跃维护中。big-arrow-on-the-screen 最近一次提交是在 2026年10月18日。
big-arrow-on-the-screen 适合用来做什么?
代理需要用户授予权限时,告诉用户该点击哪个按钮。 指引用户完成双因素验证、验证码或支付等代理不应代劳的步骤。 逐步带领他人操作某个应用界面,或在屏幕共享时协助家人。 录制演示视频或生成带标注截图时高亮界面元素。
big-arrow-on-the-screen 怎么安装和运行?
通过 Homebrew 安装: brew install franzenzenhofer/tap/bigarrow 为 Claude Code 和 Codex 安装技能: bigarrow install-skill 用箭头指向某个界面元素: bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"
在哪里获取 big-arrow-on-the-screen?
源代码和安装说明在 GitHub 上:https://github.com/franzenzenhofer/big-arrow-on-the-screen

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目