Beacon documentation

Beacon gives your agent a native Mac browser where you can see its work, steer it, and take over. You and the agent share one window and tab strip. Your own tabs stay usable while an agent works in its marked tabs.

The app bundle is Beacon.app and the command-line tool is beaconctl. The app includes the CLI, Node.js, and browser helpers in one installation.

Get started

Install the app on an Apple Silicon Mac running macOS 15 or later, then run your first agent task. The app includes its command-line tool, Node.js runtime, and browser helpers.

Beacon supplies the browser and automation tools. Your coding agent or MCP client supplies the model and decides what to do. Use agent scripts from a shell, or connect an MCP client.

Use the browser together

Browser controls explains agent tabs, Take Over, Stop, and what survives a restart. Login profiles explains how to copy supported Chrome or Safari login cookies into the shared browser profile.

The CLI and local API guide covers method discovery, request identities, and local authentication. For failed commands or differences from Chromium automation, use troubleshooting.