big-arrow
Point at something on the human's macOS screen with a big arrow and a sign ("Franz, click HERE"), and hand over values, secrets and questions on a floating cue card, 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; also to hand over credentials, a password, token, 2FA code, IBAN or command to paste, or to ask the human a question or a choice while they are away from 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.
How do I install this agent skill?
npx skills add https://github.com/franzenzenhofer/big-arrow-on-the-screen --skill big-arrowIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The big-arrow skill provides a UI overlay tool for macOS that allows an agent to point at screen elements and display cue cards. It includes features for retrieving secrets from local managers like Keychain and 1Password to display them to the user, and it suggests setting up a persistent execution hook in the agent's configuration for automated cleanup.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
big-arrow
bigarrow draws a click-through arrow with a sign, needs no permission and never takes the
focus. Point at the thing itself, a line in the terminal is easy to miss.
Needs bigarrow 0.5.1 or newer. If bigarrow --version prints an older one, run
brew upgrade franzenzenhofer/tap/bigarrow first: an old binary has no card and prints
{{value}} as plain text.
open "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture"
bigarrow start --element "Ghostty" --app "System Settings" --text "Franz, switch this on: Ghostty may record your screen" --say
# watch for the result (page changed, job continued, file appeared), then:
bigarrow stop
Rules
- Open the exact pane or URL yourself, then point at the one control left for the human. Never walk them through menus. The human clicks; you point.
- The sign is one full sentence naming the action ("Franz, click Save", never "here"). When the click approves, grants, pays, signs, sends or deletes, add what happens: "Franz, click Pay: 49 EUR to Hetzner". The human decides; the facts go on the sign, not only in the terminal.
--saywhen the human may not be looking. Time-critical (code expires, page times out, job waits):--color red --sayand say by when: "Franz, enter the 2FA code now, it expires in 60 s".- Something to paste (a command you may not run, a URL, a code): put it on the sign as
{{value}}. The human sees the value on a copy button (no braces); one click copies all of it and the arrow stays. Point at where it goes: "Franz, copy {{sudo xcodebuild -license accept}} and paste it here", then check that it was pasted. - One arrow per step;
bigarrow stopthe moment the step is done. Arrows also end alone: after 300 s, when your session exits, when the human answers (hook below). - A click on the sign or shaft, except a copy button, removes the arrow (target clicks pass
through). A removed arrow was seen: check the result, do not redraw. Skip
--close-buttonunless asked.
Cards: values, secrets, answers
One value to paste: a {{value}} chip on the sign. Two or more values, any secret, or a question:
a cue card, a floating window with copy buttons that never takes the focus.
bigarrow card --title "Franz, log in to Hetzner" --app "Google Chrome" --field "User=franz@example.com" \
--secret "Password=keychain:hetzner/franz" --link https://console.hetzner.cloud --button "done=I'm in"
bigarrow wait # blocks until an answer: {"result":"button","value":"done","copied":["User","Password"],...}
- Secrets never go on the command line (
psshows it to everyone):--secrettakes a source,pass:,keychain:<service>/<account>,op:,env:,file:, or put the value in a JSON card on stdin. They show as dots, copy as concealed and leave the clipboard after 30 s. --ask "Question?"(typed reply),--choice id=Label(2 to 6),--button id=Label.waitexits 0 for an answer, 1 when the human closed the card without one: then ask in the terminal.- A card with questions closes itself once every question is answered (
--keepkeeps it until the X); the reply'sanswershas them all. A card with only values stays until the human's X. It survives your session and the prompt hook: close it yourself when it is no longer needed,bigarrow stop --pid <pid>orbigarrow stop --cards. - A row can point: in a JSON card,
"point": {"element": "Password"}aims the arrow at where that value goes, and it moves on when the human copies the next one.start ... --card card.jsonshows an arrow and a card together. Row types and JSON: reference.md.
Targets
| You know | Use |
|---|---|
| A label in a native or Electron app | --element "Allow" --app "System Settings" |
| An app or one of its windows | --window "Safari" / --window "Safari:Inbox" |
| A spot inside a Chrome tab | --rect x,y,w,h --app "Google Chrome:<tab title>" |
| A spot in a screenshot | --at X,Y --app "<App>" |
Always pass --app (or --window) for a target inside an app: it is raised first and the arrow
hides while another app covers it. App:title matches a window title, else a tab. Coordinates
are global top-left points. Inside a Chrome page --element needs Chrome started with
--force-renderer-accessibility; otherwise convert getBoundingClientRect() to --rect
(reference.md). Unsure? bigarrow elements --app X --match "allow" or --dry-run.
Errors
Exit 2 bad input, 3 target not found (the message lists what exists), 4 permission missing: run
bigarrow doctor. Accessibility (--element, App:title, --until-click) and Screen Recording
(--window App:title) belong to the app running your shell (Terminal, Ghostty, VS Code), never
to bigarrow. Open the pane the error names (macOS 27: Accessibility is "Device Control and Data
Access") and point at that app's switch.
More (pane ids, look and timing flags): reference.md.
Setup once
~/.claude/settings.json: "hooks": {"UserPromptSubmit": [{"hooks": [{"type": "command", "command": "bigarrow stop --hook"}]}]}
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/franzenzenhofer/big-arrow-on-the-screen/big-arrow">View big-arrow on skillZs</a>