Common Issues

My coding agent isn't being intercepted

Ensure Beacon is configured for your agent. See the Coding Agent Integrations docs for setup instructions for your specific tool.

How do I disconnect all repositories?

In GitHub: Organization → Settings → GitHub Apps → Beacon Security, then suspend or uninstall the app.

How do I remove agent hooks from my local machine?

Use beacon endpoint hooks uninstall for whichever hook harness you set up:Cursor

beacon endpoint hooks uninstall --harness cursor
beacon endpoint hooks uninstall --harness cursor --level project

Claude Code

beacon endpoint hooks uninstall --harness claude
beacon endpoint hooks uninstall --harness claude --level project

Factory Droid

beacon endpoint hooks uninstall --harness factory
beacon endpoint hooks uninstall --harness factory --level project

All supported hook integrations

beacon endpoint hooks uninstall --all

After uninstalling hooks, restart the affected agent or IDE so new sessions pick up the updated hook configuration. See the hook command docs for supported harness names and flags.

beacon endpoint install fails with Collector ports are not listening

A user-mode collector cannot run beside a system-mode one, because the collector health-check port 127.0.0.1:13133 is fixed, so the install rolls back; run beacon endpoint install --user --no-start or uninstall the system endpoint first. Tracked as GitHub issue #447.

Endpoint package self-update is not running

For signed macOS package installs, self-update is off by default. Check the configured mode, updater LaunchDaemon state, and local update events:

sudo /opt/beacon/bin/beacon endpoint update status
sudo launchctl print system/com.beacon.endpoint.updater
sudo tail -n 30 /var/log/beacon-agent/system.jsonl

See Troubleshooting self-update for mode explanations, manual apply, and scheduled updater checks.

Get Started

Deploy Beacon

How Beacon Works

Manage Beacon

Agent Harness Integrations

Support

Contributing