Big Arrow on the Screen — Let your AI agents point at things on your Mac screen, guide users, or show info cards.
Analyzed by Sai Pavan Gopularam · AI · Developer Tools · View on GitHub
- Stars: 879
- Forks: 27
- Commits last 30 days: 18
- Health: Active (18 commits this month)
- Language: Swift
- License: MIT
What It Is
Imagine giving your AI agent a virtual laser pointer and a stack of customizable cue cards for your Mac screen. That's what Big Arrow on the Screen does. It's a command-line tool that lets AI agents (or any script) draw visual guides like arrows, boxes, and text, or display floating information panels over any macOS application. Crucially, these overlays are transparent to clicks and don't steal your keyboard focus, so you can interact with the underlying app normally.
This tool solves a common problem in AI-human collaboration: agents needing human input or guidance on a Mac, but only being able to print text to a terminal. Big Arrow makes the human-AI handoff visual, clear, and interactive, especially for complex tasks, sensitive operations, or detailed step-by-step instructions. It's about making AI assistance less abstract and more directly actionable on your desktop.
License Verdict
MIT License — Build and Sell Freely — Commercial Use Approved • No Copyleft Restrictions
The MIT license permits unlimited commercial use, distribution, modification, and private use. You can incorporate this tool into proprietary software and sell it without needing to open-source your own code. The only requirement is to include the original copyright and license notice in your product or documentation.
How to Use It
Install the command-line tool using Homebrew, then optionally integrate it as a skill for Claude Code or Codex. This provides the `bigarrow` command for use in scripts or AI agent prompts to create on-screen guides.
Prerequisites:
- macOS 14+
- Homebrew
Estimated setup time: 10 minutes.
brew install franzenzenhofer/tap/bigarrow
bigarrow install-skill # Optional, for AI agent integration
bigarrow point --element "Allow" --app "System Settings" --text "Hello world!"
What I'd Build With This
Interactive Mac App Onboarding Guides (micro-saas)
Offer a service for macOS app developers to create interactive, step-by-step onboarding guides. Developers define the steps, and your service generates `bigarrow` scripts or agent prompts that visually walk new users through the app's features. This improves user retention and reduces support queries.
Effort: 1 Week Build Time · Target: macOS App Developers · Pricing: $99/mo per app
AI-Powered Mac Troubleshooting Assistant (saas)
Develop a desktop application or agent integration that uses `bigarrow` to visually guide users through troubleshooting steps or complex Mac configurations. When a user reports an issue, the AI agent can 'point' them to the right settings, buttons, or display cue cards with necessary information. This is like a smart, interactive help desk for Mac users.
Effort: 3 Months Build Time · Target: IT Support Teams, Power Users · Pricing: $49/user/month for teams
Secure Human-in-the-Loop Workflow Automation (enterprise)
Build an internal enterprise tool to automate complex, multi-step workflows on macOS that require human approval or sensitive data handling. The AI agent performs most steps, then uses `bigarrow` to present cue cards for human input (e.g., 'Approve transaction', 'Enter 2FA', 'Copy secret from vault') or to visually confirm actions. This ensures security and compliance in critical operations.
Effort: 6 Months+ Build Time · Target: Enterprise Operations/Security · Pricing: Custom Annual License ($50k+)
Sai Pavan Gopularam's Take
This is a clever tool for bridging the gap between AI agents and human users on macOS. I've seen countless times where an agent needs a human to click 'Allow' or confirm a step, and this makes that handoff seamless and visual. You could easily build a micro-SaaS selling guided onboarding flows for Mac apps, potentially generating $5k/month by charging developers a flat fee per app.
Watch Out For
- No Clicks or Typing: `bigarrow` is a visual guidance tool; it points and displays information but does not automate clicks or keyboard input. Human interaction is always required for performing actions.
- Agent or Script Dependency: While you can use it manually, its primary utility and advanced features (like secure secret handling or complex card interactions) are designed to be driven by AI agents or sophisticated scripts.
- Accessibility Permissions for Element Targeting: Though drawing requires no special permissions, using `--element` to target specific UI elements (like buttons or text fields) requires the calling process (your agent or script) to have macOS Accessibility permissions.
I break down trending repos like Big Arrow on the Screen every week — join the newsletter.