> ## 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.

# Welcome to Beacon

> Beacon is the open-source self-improving memory layer for AI agents.

<picture>
  <source media="(prefers-color-scheme: dark)" />

  <img src="https://mintcdn.com/agent-beacon/FBLoxBWFUHzHBWoF/logo/beacon-lockup-light.svg?fit=max&auto=format&n=FBLoxBWFUHzHBWoF&q=85&s=f19653e6a00df99ae2f383de9c457332" alt="Beacon logo" width="720" height="252" data-path="logo/beacon-lockup-light.svg" />
</picture>

Beacon is the open-source trace and reviewed-memory layer for AI agents. It was designed and built by the founders of [Asymptote Labs](https://asymptotelabs.ai/).

It captures agent activity across Claude Code, Cursor, Codex, OpenCode, and 20+ other harnesses, creating a shared history of how agents work across local, CI, and cloud environments.

Use Beacon to understand agent behavior, debug workflows, and explicitly turn reviewed agent runs into reusable knowledge that compounds across harnesses.

## Install Beacon

<Tabs>
  <Tab title="macOS">
    Install Beacon with Homebrew:

    ```bash theme={null}
    brew trust asymptote-labs/tap
    brew tap asymptote-labs/tap
    brew install beacon
    beacon version
    ```

    See the [macOS install guide](/platforms/macos) to configure endpoint telemetry or deploy the signed package to a fleet.
  </Tab>

  <Tab title="Windows">
    Download `BeaconEndpointAgent-<version>-x64.msi` from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest), then run PowerShell as an administrator:

    ```powershell theme={null}
    msiexec /i BeaconEndpointAgent-<version>-x64.msi
    & "$env:ProgramFiles\Beacon\bin\beacon.exe" version
    ```

    See the [Windows install guide](/platforms/windows) for silent installation, checksum verification, and service management.
  </Tab>

  <Tab title="Linux">
    Download the `.deb` or `.rpm` for your architecture from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest):

    <CodeGroup>
      ```bash title="Debian, Ubuntu" theme={null}
      sudo apt install ./beacon_<version>_linux_amd64.deb
      beacon version
      ```

      ```bash title="Fedora, RHEL, Rocky, Alma" theme={null}
      sudo dnf install ./beacon_<version>_linux_amd64.rpm
      beacon version
      ```
    </CodeGroup>

    Replace `amd64` with `arm64` on ARM systems. See the [Linux install guide](/platforms/linux) for rootless and tarball installation.
  </Tab>
</Tabs>

## Getting started

Start collecting agent traces in minutes, then use Beacon to explore sessions, understand workflows, and build shared knowledge from every agent run.

<CardGroup cols={2}>
  <Card title="Beacon Overview" icon="rocket" href="/get-started/overview">
    Understand the problem Beacon solves and when to use open-source, managed, or private deployments.
  </Card>

  <Card title="Managed Beacon" icon="key" href="/deployment/managed">
    Review managed platform options for hosted agent runtime visibility, governance, and enterprise rollout support.
  </Card>
</CardGroup>