Website · Docs · Discord · Install · Commands
Beacon captures agent session history across Claude Code, Cursor, Codex, OpenCode, and 20+ other harnesses, then turns useful workflows, corrections, and debugging patterns into reusable knowledge for future agents.
A problem solved by one agent shouldn't need to be learned from scratch by another.
Beacon Overview
Beacon is an open-source memory layer for AI coding agents that learns from your work across Claude Code, Cursor, Codex, OpenCode, and 20+ other harnesses. It captures full session history, identifies useful workflows, corrections, and debugging patterns, and makes that knowledge reusable by future agents. Built for developers who want agent knowledge to compound across tools instead of disappearing when a session ends.
Key Capabilities:
- Cross-harness history - sessions from Claude Code, Cursor, Codex, OpenCode, Cline, and 20+ harnesses in one place
- Knowledge that compounds - workflows, corrections, debugging patterns, and repo conventions that survive beyond a single session
- Shared agent memory - reviewed knowledge future agents can retrieve through MCP or Agent Skills
- Exact session replay - prompts, responses, tools, commands, edits, approvals, MCP activity, and tokens in one trace
- Local-first portability - durable JSONL, explicit destinations, and no harness lock-in
🚀 Quick Start
Beacon is open source and local-first. Interactive endpoint setup signs in through beacon.sh and preselects Beacon Managed, with an explicit Local opt-out. Signing in forwards nothing; confirming Managed installs Beacon and connects this machine in the same command, and the confirm screen says so before you accept. System, package, MDM, and CI installation paths remain noninteractive and account-free.
1. Install Beacon
macOS
brew trust asymptote-labs/tap
brew tap asymptote-labs/tap
brew install beacon
beacon endpoint install
Linux
Install the latest .deb or .rpm for your distribution and architecture (Debian, Ubuntu, Fedora, RHEL, Rocky, Alma):
curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bash
The installer downloads the package for your architecture, verifies it against the release checksums.txt, and installs it with apt-get or dnf. Set BEACON_VERSION=<version> to install a specific release.
Prefer not to pipe a script into your shell? Either read the script before