Asymptote-Labs / agent-beacon

Self‑improving memory for coding agents 
 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
---
## 🎬 Demo
https://github.com/user-attachments/assets/38995612-84e9-4989-a905-0099f77955f0
---
## 🚀 Quick Start
Beacon is open source and local-first. Interactive endpoint setup signs in through
beacon.sh and preselects Beacon Cloud, 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. Setup then ends
on a short summary and opens the hosted dashboard at
beacon.sh/dashboard. System, package, MDM, and CI
installation paths remain noninteractive and account-free.
### 1. Install Beacon
**Copy & paste setup prompt into your coding agent**
 [code] 
 macOS 
 [code] 
 Linux 
Install the latest `.deb` or `.rpm` for your distribution and architecture (Debian, Ubuntu, Fedora, RHEL, Rocky, Alma):
 [code] 
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= ` to install a specific release.
**Prefer not to pipe a script into your shell?** Either read the script before you run it:
 [code] 
Or skip the script and run its steps yourself: pick a version, download the package and `checksums.txt`, verify the package, and install it with your package manager.
 [code] 
`checksums.txt` is published with the release, so it catches a corrupted or swapped download but does not prove who built the release. To check that, verify the package's build-provenance attestation, which shows it was built