Asymptote-Labs /agent-beacon

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

★ 3,553⑂ 320👁 7⑃ 1,222● 84▤ 180
GoMITCreated 2026-05-12beacon.sh
下载:v1.3.62v1.3.62 ↓1.3.622026-11-16
3,553
stars
320
forks
7
watchers
1,222
prs
84
issues
180
releases

README

Self‑improving memory for coding agents


  
  
  
  
  
  



  Website
  ·
  Docs
  ·
  Discord
  ·
  Install
  ·
  Commands



  
  
  


⭐ Help us reach more developers and grow the Beacon community. Star this repo!

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

text
Read https://beacon.sh/start.md then set me up on Beacon



macOS

bash
brew update
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):

bash
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= to install a specific release.

Prefer not to pipe a script into your shell? Either read the script before you run it:

bash
curl -fsSLO https://github.com/asymptote-labs/agent-beacon/r

Top issues

Discussions

Latest release

v1.3.62 v1.3.62 2026-11-16
Changelog
 Features
 9a66853cece37e47bf94a8302257cba7f40f6742 feat(telemetry): a PostHog client for CLI product events, opt-out and first-run notice
 042e9f9b78efd879355f5e3d297e493e2c5ca7ed feat(telemetry): a PostHog client for CLI product events, opt-out and first-run notice (1258)
 10fc8cc661c6d3cad02815114cd5513c6a3b6e2b feat(telemetry): cli_install_started and cli_install_completed
 82641546f9b74b0a2b224272057348eb1f400f1f feat(telemetry): cli_trace_recorded, the connect's backfill report and privacy_mode at enroll (1261) onto main
 a28a76bade1cad3a509126120ffbadbf2c45d55a feat(telemetry)

Snapshot: 2026-11-17T10:29:19Z · Data license Apache-2.0 · JSON