⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
big-arrow
Point at something on the human's macOS screen with a big arrow and a sign (\"Franz, click HERE\") using the bigarrow CLI. Use whenever the human has to look at, click, type into or choose a specific spot, button, field, window, tab or menu: show me where, point to it, which button, where do I click, zeig mir wo, guide me through this UI, the human must approve or sign something, or you need the human's hand and they may not be looking at the terminal. Mandatory when it is time-critical: a code that expires, a login or payment page that times out, a build waiting on the human.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
Let your AI agents paint big arrows, boxes and text on your screen
big-arrow-on-the-screen (bigarrow) is a macOS command-line tool, plus a skill for Claude Code and Codex, that draws an arrow and a sign on top of every window. Clicks go through to the app below, your keyboard focus stays where it is, and the arrow removes itself. MIT licensed.
Your AI agent can refactor a monorepo, write a migration and explain monads, but when it needs you to click one button it prints "please click Allow in the dialog" into a terminal you are not looking at.
bigarrowgives it a finger.
bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow: Ghostty may control your Mac"
The arrow lives in its own transparent window above all other windows, on every display and every Space. Clicks on the target land in the app underneath, and drawing needs no macOS permission at all. It is one Swift binary: no daemon, no menu-bar icon, no account, no telemetry, and, we checked twice, no AI inside. It is an arrow.
What is this actually for?
Fair question. Arrows have existed since roughly the Paleolithic. Here is what changed: software agents now do real work on your Mac, and sooner or later they reach a step only a human may do, or one the human wants to learn to do.
- "Click Allow." macOS permission prompts, OAuth consent screens, "Open with...?" dialogs. The agent can find the button but must not, or cannot, press it for you. It can now point at it.
- "Your turn." 2FA codes, CAPTCHAs, passkeys, a payment confirmation, a signature, a legal checkbox. The things an agent should never click on its own behalf. It points, you decide, it continues.
- "It's this window, not that one." You have 14 Chrome windows. The agent knows which one it means:
--window "Google Chrome:Pull request". It even picks the right tab:--app "Google Chrome:Pull request". - "I need you, and you're making coffee."
--sayreads the sign aloud. Your Mac will literally call you back to your desk. - "Show me how." Ask your agent how to do something in Keynote, Blender or System Settings, and it points at each control in turn instead of describing it:
start, wait until you acted,stop, next step. Like a product tour, minus the product. - Helping someone else. Install it on a parent's Mac, and the agent there can show them how to save a document as PDF. Pointing beats "the button at the top, no, the other top".
- Remote help. "No, the other gear icon." Point at it instead of describing it.
- Demos, screencasts, docs. Highlight what matters while recording, or render the arrow straight into a PNG with
--pngfor documentation. - Debugging coordinates. Not sure your Accessibility, screenshot or Peekaboo coordinates are right? Point at them and look.
--dry-run --jsontells you where it would point without drawing.
Situations we have all been in
Staged with a neutral demo dialog and recorded with the real bigarrow on a clean CI runner (BACKDROP_ARGS=--cover scripts/funny-scenes.sh). The dialogs are fake. The feelings are real.
 |  |
--color green | --shape zigzag --color orange |
 |  |
--color purple | --close-button, because the human gets the last word |
 |  |
three starts, one button, zero ambiguity | --style box --corners sharp, plus a lesson about macOS permissions |
 | |
--shape spiral: once around the sign, then to the button |
What it is not: a screen annotator for humans, a click bot, or a screenshot tool. It never clicks, types or captures anything. It only points. Deliberately.
Real apps, real use cases
No fake dialogs this time. Real apps on the test Mac (macOS 27), neutral demo content, a fresh browser profile, and the real bigarrow, staged by scripts/real-scenes.sh. Every command below is exactly what ran; the script only adds --no-animation --json for the screenshot.
open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"
bigarrow start --element Terminal_Toggle --app "System Settings" \
--text "Franz, switch this on: Terminal may control your Mac" --from right
Guiding a human through a permission: a deep link opens the exact pane, the arrow finds the one switch, and the sign says what it does. (On macOS 27 the pane is called Device Control and Data Access. Nobody would have found it by the old name.)
bigarrow start --element Animate --app Keynote --role radiobutton --text "1. Click Animate" --from right
bigarrow start --element "Add an Effect" --app Keynote --text "2. Add an Effect" --from right
Teaching an app: "Where do I add a transition?" Two numbered steps, both on screen, in a toolbar that has given up on words.
bigarrow start --element PDF --role button --app TextEdit \
--text "Mom, click PDF, then Save as PDF" --from bottom
Helping a parent over a screen share, without the twenty minutes of "the little button, bottom left, no, left".
bigarrow start --app "Google Chrome:Sourdough" --element "Sourdough - Wikipedia" --role radiobutton \
--text "It's this tab, not the other 13" --from top
--app "App:tab title" brings the right window to the front and selects the tab before it points. The agent knew which tab it meant. Now you do too.
bigarrow start --element Group --role menubutton --app Finder \
--text "No, the other grid icon. This one." --from top
Remote help, updated for macOS 27: the gear icon is gone, but there are now two grid icons, and it is always the other one.
Install
brew install franzenzenhofer/tap/bigarrow
bigarrow install-skill # teaches Claude Code (~/.claude/skills) and Codex (~/.agents/skills)
From source: swift build -c release (Xcode 16 or newer, macOS 14 or newer), binary at .build/release/bigarrow. The binary is Swift only; the shell and Python files in scripts/ record screenshots and run tests.
The three commands an agent needs
bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow" # by label
bigarrow point --at 760,500 --text "Franz, click HERE" # by coordinate
bigarrow start --window "Safari:Inbox" --text "This window" && bigarrow stop # until stopped
Every arrow ends by itself. Nob
// HOW IT'S BUILT
KEY FILES