bigarrow is a standalone Swift CLI for macOS that draws transient, click‑through overlays — arrows, rings, or boxes with optional text labels — to guide human attention without stealing focus or requiring special permissions. Invoked via bigarrow point , it accepts targets by UI label ( --element "Allow" --app "System Settings" ), screen coordinates ( --at 760,500 ), window or tab titles ( --window "Safari:Inbox" ), or Peekaboo JSON snapshots. Overlays appear on top of all spaces and displays, respecting Stage Manager and full‑screen apps, and can be configured with --shape (straight, bend, zigzag, spiral), --style (arrow, ring, box), --size (S/M/L), --corners (round/sharp), --color (named or hex), and optional --close-button for manual dismissal. The arrow automatically disappears after a duration (default 8 s, configurable via --duration ) or when the owning agent process exits; bigarrow start and bigarrow stop allow persistent arrows that can be cleared by a hook or the --close-button . Audio feedback is provided with --say , and --png renders the overlay to an image for documentation. Internally, bigarrow uses macOS Accessibility (via the host shell) for element lookup and window raising, Core Animation for rendering (≈1.4 % CPU on CI), and never clicks, types, or captures screen content. It is distributed as a single binary ( brew install franzenzenhofer/tap/bigarrow ) or built from source with Xcode 16+/macOS 14+, and includes agent‑skill definitions for Claude Code and OpenAI Codex. The project ships 87 automated unit tests and 17 behavior‑validation tests, passing on macOS 15‑27.
Read original
hackernews