Beacon
A self-improving, cross-harness memory layer that turns coding-agent session history into reusable knowledge.
- Source repo
- Asymptote-Labs/agent-beacon
- Stars
- ★ 3.3k
- Last updated
- today
- License
- MIT
- Primary language
- Go
- FA score
- 58/100 · Major gaps
At a glance
- How it runs
- Works with
- Portable with changesCodex · Claude CodeChatGPT · Claude.ai · OpenAI API · Claude API (Partial support)
- Cost
- Free tier plus a paid hosted plan
- Setup effort
- Low · running in minutes
- You'll need
- Typical use
- Developers who move between Claude Code, Cursor and Codex and don't want a solved problem re-learned in each tool.
- Not a fit if
- Teams that must stay fully offline with zero account prompts (setup signs in to beacon.sh)
- Developers using one harness who don't need knowledge shared across tools
- Users who want a hosted memory service without installing an endpoint
- Source review
- 58/100 · Major gaps
What does this agent do, and when should you use it?
Beacon is an MIT-licensed memory layer from Asymptote Labs for AI coding agents. It captures session history across Claude Code, Cursor, Codex, OpenCode, Cline and 20+ other harnesses using OTLP, hooks, plugins and polling, then normalizes it into a single OpenTelemetry-based event model covering prompts, responses, tool calls, commands, file activity, approvals, MCP interactions and token usage. By default the output is local JSONL at ~/.beacon/endpoint/logs/runtime.jsonl, browsable via beacon traces or a read-only local dashboard; reviewed workflows, corrections and debugging patterns become knowledge that future agents can retrieve through MCP or Agent Skills. The same normalized stream can also be forwarded to existing infrastructure such as Splunk, Datadog, Elastic, Microsoft Sentinel, S3 or GCS, or to Beacon Cloud. The design is local-first, portable, and explicitly not tied to a single harness.
Beacon collects activity where agents actually execute: local harnesses via OTLP, hooks or polling; browser chats via a Chromium/Firefox extension that emits to local OTLP; cloud agents via sandbox hooks writing to GCS or S3; CI jobs via beacon ci exec, which spins up a temporary local collector; and SDK surfaces via @asymptote/sdk and OpenLLMetry spans. Captured sessions are normalized into one event model, written as JSONL, and optionally forwarded to SIEM, log-aggregation or object-storage destinations. beacon traces opens a terminal browser for event timelines and token usage; beacon endpoint dashboard serves a read-only local web view with sandboxed HTML lenses such as diffs, token bills, risk-grouped security reviews and approval timelines. On the memory side, Beacon Skills and the beacon-managed MCP server registered by beacon mcp connect let harnesses search shared knowledge, while the local beacon mcp serve never touches the network.
- Developers who move between Claude Code, Cursor and Codex and don't want a solved problem re-learned in each tool.
- Security teams that need coding-agent prompts, tool calls and approvals streamed into Splunk or Microsoft Sentinel for audit.
- Platform teams that want searchable traces of agent work in CI using
beacon ci exec. - Teams that want repeated corrections and repo conventions distilled into Agent Skills for future agents.
- Individual developers reviewing what each harness actually did and how many tokens it spent.
How do you install or deploy this agent?
On macOS use Homebrew:
brew update
brew trust asymptote-labs/tap
brew tap asymptote-labs/tap
brew install beacon
beacon endpoint installOn Linux, run the official installer, which verifies checksums.txt and installs with apt-get or dnf:
curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bashOn Windows, download the x64 MSI and install:
msiexec /i BeaconEndpointAgent-<version>-x64.msiYou can also hand setup to a coding agent with the prompt:
Read https://beacon.sh/start.md then set me up on BeaconHow do you use this agent?
After installation, run the interactive endpoint setup and confirm where data goes (the wizard preselects Beacon Cloud; choose Local to keep everything on the machine):
beacon endpoint installWork in Claude Code, Cursor, Codex or another harness as usual; Beacon captures in the background. Then inspect traces and token usage:
beacon tracesOr open the read-only local dashboard:
beacon endpoint dashboardTo let agents search shared memory, register the managed MCP server (each harness signs in with OAuth on first connect; no token is written):
beacon mcp connectInstall or remove Beacon Skills:
beacon skills install
beacon skills uninstallCheck the signed-in account or disconnect the endpoint:
beacon whoami
beacon endpoint disconnectWhat are this agent's strengths and limitations?
- One capture layer across 20+ harnesses, with an explicit support matrix (Claude Code, Cursor, Codex, OpenCode, Cline, Gemini CLI and more).
- Local JSONL plus a read-only local dashboard keeps the data path auditable and independent of any UI.
- Normalizes to an OpenTelemetry event model, so it plugs into existing Splunk, Sentinel, Wazuh, S3 or GCS setups.
- Memory is reusable through both MCP and Agent Skills, and
beacon mcp servestays fully local.
- Coverage is uneven across harnesses — several cells are “–” or “~” (e.g. no Cursor tokens, partial VS Code fields).
- The interactive setup steers to a beacon.sh sign-in and preselects Beacon Cloud forwarding; staying local requires an explicit Local choice.
- Managed forwarding depends on a Beacon Cloud account, and SIEM forwarding requires your own ingest tokens or collection rules.
- Lenses run sandboxed HTML, but the docs note the sandbox cannot block every browser exfiltration path, so only trusted lenses should be installed.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Beacon This agent | 58 · Major gaps | CLIFreemium | ★ 3.3k | today | Go | Codex · Claude Code |
| AI Dev Tools Zoomcamp: AI-Native Software Engineering | 32 · Major gaps | Web appFree | ★ 1.7k | 10d ago | Python | — |
| PRO-LONG | 57 · Major gaps | CLIFree | ★ 465 | 2d ago | Python | Codex · Claude Code |
| AI DevKit | 48 · Major gaps | CLIFree + model costs | ★ 1.7k | 1d ago | TypeScript | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
Data-flow transparency is strong: default local JSONL, explicit destinations, uninstall retention flags, and restricted log access are documented, so data_flow_transparency scores 3. However, install writes configuration into many harnesses, installs hooks and skills, and preselects Beacon Cloud forwarding, which is broad permission and external effect, so least_privilege and external_effects score 1. A confirmation screen and Local opt-out exist but cloud is preselected, so user_confirmation scores 2. Redaction, truncation, and 0600 key files are described, but the browser extension defaults to full prompt/response retention, so sensitive_data_handling scores 2. Dependency security is only checksums and an attestation mention with no dependency manifest or vulnerability governance, so dependency_security scores 1. Uninstall with --keep-logs/--keep-config provides a rollback path, so rollback scores 2. Attribution is only README and LICENSE naming Asymptote Labs with an unverified publisher, so source_attribution scores 1.
Install, uninstall, forwarding, and session-sync descriptions are broadly consistent, so self_consistency scores 2. Dependency availability relies on a Homebrew tap, release archives, and checksums with no lockfile or offline evidence, so dependency_availability scores 1. Failure messaging distinguishes PASS/FAIL/INCONCLUSIVE and WARN in the sandbox docs, so failure_messages scores 2.
README covers 20+ harnesses, browser chat, cloud agents, CI, and SDKs, so audience_and_scenarios scores 3. Capability boundaries are partly stated (macOS cannot be sandbox-tested, hook write failures are warnings) but remain promotional, so capability_boundaries scores 2. Trigger precision is weak: hooks, OTLP, and poll paths coexist without precise trigger conditions or deduplication, so trigger_precision scores 1. Environment fit covers macOS/Linux/Windows and systemd/launchd but lacks ARM and macOS sandbox coverage, so environment_fit scores 2.
Install notes are thorough (Homebrew, deb/rpm, MSI, manual archives, checksums), so install_notes scores 3. Information architecture has docs and README navigation but splits links across docs.beacon.sh and docs.asymptotelabs.ai, so information_architecture scores 2. Naming stability explains beacon-vector vs vector but product and domain names diverge, so naming_stability scores 2. Examples exist but no consolidated FAQ, so examples_and_faq scores 2. Known limitations are listed in the sandbox doc, so known_limitations scores 2. LICENSE is full MIT, so license scores 3. Versioning is only a badge and a version example with no CHANGELOG, so versioning_changelog scores 1. Maintenance responsibility is only a security email and Discord with an unverified publisher, so maintenance_responsibility scores 1.
Output is local JSONL plus a dashboard that can be inspected directly, so output_usability scores 2. Cross-harness memory reuse has a clear value proposition but no quantified evidence, so marginal_value scores 2. Cost includes installing a service, modifying many harness configs, and possibly uploading 30 days of history, with insufficient cost-benefit discussion, so cost_benefit scores 1.
Most README capability claims point to external docs rather than in-repo verifiable files, so claim_traceability scores 1. In-repo files (README, SECURITY, docs) partially corroborate each other but lack tests or code evidence, so cross_source_corroboration scores 1. Facts and inferences (e.g., 'self-improving') are mixed, so fact_inference_separation scores 1.
- Install writes configuration into many harnesses, installs hooks/skills, and the wizard preselects Beacon Cloud forwarding, which may upload the last 30 days of session history; verify the Local option and confirmation screen first.
- The browser extension defaults to full retention of complete prompt and response text, so sensitive data may land in local logs unless retention is changed.
- Publisher identity is unverified and documentation links split across beacon.sh and asymptotelabs.ai, so attribution and maintenance responsibility should be treated cautiously.
- Dependency security is only checksums and an attestation mention with no dependency manifest or vulnerability governance evidence; static review cannot confirm supply-chain safety.
- This is a static source review with no installation or execution performed; capability claims and test quality are not independently verified.
FAQ
Does Beacon send my sessions to the cloud by default?
beacon endpoint disconnect stops forwarding at any time.Which coding agents are supported?
Is it free?
How do I capture agent traces in CI?
beacon ci exec, which starts a temporary local collector that records sessions, prompts, tool calls, commands and file activity for the CI job.