The handoff is now part of the interface.
A desktop agent can see a dialog and still leave the human hunting for it. The request lands in a terminal while the control sits in another app, on another Space, or under another window. The failure is spatial. More prose does not fix it.
bigarrow is a new macOS command line tool built for that gap. It can point at a coordinate, rectangle, window, or accessible element. Its overlay is designed to avoid stealing focus, and each command returns an exit code. The default point command expires after eight seconds.[1]
A good visual handoff says where, why, who acts, and when the marker dies.
Pointing is weaker than clicking.
That is the useful part. The tool says it does not click, type, or capture the screen. It draws. A human still owns the action. That makes the overlay suitable for consent screens, passkeys, payment confirmation, and other steps where visibility should improve without transferring authority.
Anthropic's computer use documentation recommends human confirmation for actions with real consequences and for affirmative consent. It lists financial transactions and terms acceptance as examples. The same guidance warns that content on pages and in images can carry hostile instructions.[2] A bright arrow does not make a request trustworthy. The sign must state why the agent stopped, and the human must inspect the underlying control.
The target needs a stable coordinate story.
A marker can be precise and wrong. Displays move. Windows resize. Browser content may not expose an accessible element. The repository accepts global top-left logical coordinates and can target named windows or accessible elements. It also documents a browser limitation for element targeting in Chrome unless renderer accessibility or VoiceOver is active.[1]
Keep the target method in the handoff record. Use a semantic element when the platform exposes one. Use a window-relative or display-relative coordinate when it does not. If the target moves, invalidate the marker rather than pointing at the old pixel.
Capture and guidance are separate jobs.
Playwright can capture a full page, a clipped area, or one element. It can also return the image as a buffer for later processing.[3] That is evidence collection. An on-screen marker is live guidance. Mixing them creates stale screenshots that look like current instructions.
Store the screenshot with its page state and revision. Keep the live overlay short-lived. If the operator has already changed windows, refreshed the page, or completed the action, clear the marker.
Ship the stop rule with the arrow.
The repository ties markers to time limits, explicit stop commands, owner-process exit, and an optional close button. Those are not decoration. They prevent an old instruction from surviving into a new screen state.
We inspected revision ab03ccf979504757b71cb8e6c4f4d019d9295a33 and its Swift package structure. We did not run the application because this inspection host is Linux and the package requires macOS 14 or newer. The repository's test counts and platform results remain publisher claims, not independent results from this garage.