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
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
#1172Beacon Cloud connect fails on Windows: forwarder needs launchd/systemd and Windows builds don't ship Vector (v1.3.52)4 comments · 2026-11-03#1284delivery: sandboxed hooks (bwrap containers) silently drop events for every harness except dsh — generalize the 848b6811 spool-and-drain1 comments · 2026-11-13#1298Beacon endpoint traces search, show, and JSON output ignore the command writer0 comments · 2026-11-14#1296Dashboard event reads re-sort the kept window on every matching line0 comments · 2026-11-14#1294Correlation rules treat events with no session id as one session0 comments · 2026-11-14#1292Page Down on an empty trace list sets the selection to -10 comments · 2026-11-14#1288Proposal: optional tamper-evident sealing of the local runtime.jsonl (daily digest, RFC 3161 + OpenTimestamps)0 comments · 2026-11-13#1282Proposal: delegation and authority attributes for agent events0 comments · 2026-11-13
Discussions
#614old sessions1 comments · 2026-09-22#39Welcome to agent-beacon Discussions!0 comments · 2026-05-20
Latest release
v1.3.62 v1.3.62 2026-11-16Changelog 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)