GitHub - franzenzenhofer/big-arrow-on-the-screen: Let your AI agents paint big arrows, boxes and text on your Mac screen. One CLI, click-through, gone
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, your keyboard focus stays put, and the arrow removes itself. MIT licensed.
Real apps · Looks · Creative arrows · Starred by · What is it for? · Install · Commands · FAQ · How we know it works · For agents · Plan · Prior art · License
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. bigarrow gives it a finger.
bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow: Ghostty may control your Mac"
One transparent window above everything, on every display and every Space. Drawing needs no macOS permission at all. One Swift binary: no daemon, no menu-bar icon, no account, no telemetry, and, we checked twice, no AI inside. It is an arrow.
Real apps, real use cases
Since macOS Sonoma one click on the wallpaper sends every window running for the edges, which iMore called "the most annoying change in Mac update history". The fix hides behind an option named after Stage Manager. Six steps, six arrows, every one a different look, real clicks on a real Mac (MP4, recorded by scripts/wallpaper-video.sh; the account name in the Apple menu and the desktop widgets are pixelated).
No fake dialogs this time. Real apps on the test Mac (macOS 27), neutral demo content, the real bigarrow, staged by scripts/real-scenes.sh. Every command is exactly what ran (the script adds --no-animation --json for the screenshot). An arrow should match the mood: a green "go ahead", a black "don't", a ring for "this little thing", a box for "this whole thing".
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 --color green --close-button
bigarrow start --element Add --role button --app "System Settings" \
--text "Not in the list? Plus. Then find it." --from bottom-right --style ring --color orange --shape zigzag --size S
A deep link opens the exact pane, the arrow finds the one switch. Plan B is orange and zigzagging, because plan B always is. (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 \
--style ring --color purple
bigarrow start --element "Add an Effect" --app Keynote --text "2. Add an Effect" --from right \
--style box --corners sharp --color "#FF9F0A" --shape straight
bigarrow start --element Play --app Keynote --role button --text "3. Press play. Bask in the applause." \
--from top --color teal --shape zigzag --size S
"Where do I add a transition?" Three steps, all on screen at once, in a toolbar that has given up on words.
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, your keyboard focus stays put, and the arrow removes itself. MIT licensed.
Real apps · Looks · Creative arrows · Starred by · What is it for? · Install · Commands · FAQ · How we know it works · For agents · Plan · Prior art · License
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. bigarrow gives it a finger.
bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow: Ghostty may control your Mac"
One transparent window above everything, on every display and every Space. Drawing needs no macOS permission at all. One Swift binary: no daemon, no menu-bar icon, no account, no telemetry, and, we checked twice, no AI inside. It is an arrow.
Real apps, real use cases
Since macOS Sonoma one click on the wallpaper sends every window running for the edges, which iMore called "the most annoying change in Mac update history". The fix hides behind an option named after Stage Manager. Six steps, six arrows, every one a different look, real clicks on a real Mac (MP4, recorded by scripts/wallpaper-video.sh; the account name in the Apple menu and the desktop widgets are pixelated).
No fake dialogs this time. Real apps on the test Mac (macOS 27), neutral demo content, the real bigarrow, staged by scripts/real-scenes.sh. Every command is exactly what ran (the script adds --no-animation --json for the screenshot). An arrow should match the mood: a green "go ahead", a black "don't", a ring for "this little thing", a box for "this whole thing".
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 --color green --close-button
bigarrow start --element Add --role button --app "System Settings" \
--text "Not in the list? Plus. Then find it." --from bottom-right --style ring --color orange --shape zigzag --size S
A deep link opens the exact pane, the arrow finds the one switch. Plan B is orange and zigzagging, because plan B always is. (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 \
--style ring --color purple
bigarrow start --element "Add an Effect" --app Keynote --text "2. Add an Effect" --from right \
--style box --corners sharp --color "#FF9F0A" --shape straight
bigarrow start --element Play --app Keynote --role button --text "3. Press play. Bask in the applause." \
--from top --color teal --shape zigzag --size S
"Where do I add a transition?" Three steps, all on screen at once, in a toolbar that has given up on words.
Kategori:
Off Topic
Bu konuyu EL11.Net forumunda tartışmak ister misiniz?
Forumda Gör
