> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beacon.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues

> Solutions for common issues when setting up and using Beacon.

<AccordionGroup>
  <Accordion title="My coding agent isn't being intercepted">
    Ensure Beacon is configured for your agent. See the [Coding Agent Integrations](/runtimes/cursor) docs for setup instructions for your specific tool.
  </Accordion>

  <Accordion title="How do I disconnect all repositories?">
    In GitHub: **Organization → Settings → GitHub Apps → Beacon Security**, then suspend or uninstall the app.
  </Accordion>

  <Accordion title="How do I remove agent hooks from my local machine?">
    Use `beacon endpoint hooks uninstall` for whichever hook harness you set up:

    **Cursor**

    ```bash theme={null}
    beacon endpoint hooks uninstall --harness cursor
    beacon endpoint hooks uninstall --harness cursor --level project
    ```

    **Claude Code**

    ```bash theme={null}
    beacon endpoint hooks uninstall --harness claude
    beacon endpoint hooks uninstall --harness claude --level project
    ```

    **Factory Droid**

    ```bash theme={null}
    beacon endpoint hooks uninstall --harness factory
    beacon endpoint hooks uninstall --harness factory --level project
    ```

    **All supported hook integrations**

    ```bash theme={null}
    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](/cli/hooks#beacon-endpoint-hooks-uninstall) for supported harness names and flags.
  </Accordion>

  <Accordion title="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](https://github.com/asymptote-labs/agent-beacon/issues/447).
  </Accordion>

  <Accordion title="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:

    ```bash theme={null}
    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](/cli/upgrade#troubleshooting-self-update)
    for mode explanations, manual apply, and scheduled updater checks.
  </Accordion>
</AccordionGroup>

<Info icon="circle-question" title="Still stuck?">
  Contact us at [support@asymptotelabs.ai](mailto:support@asymptotelabs.ai) and we'll help you get sorted.
</Info>