Beacon

A self-improving, cross-harness memory layer that turns coding-agent session history into reusable knowledge.

Stars
★ 3.3k
Last updated
today
License
MIT
Primary language
Go

At a glance

How it runs
CLISelf-hosted service
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
macOS with Homebrew, or Linux .deb/.rpm, or Windows x64 MSIBeacon endpoint (beacon endpoint install)Shell / CLINetwork accessLocal filesystemMCP Server
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

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.

  1. Developers who move between Claude Code, Cursor and Codex and don't want a solved problem re-learned in each tool.
  2. Security teams that need coding-agent prompts, tool calls and approvals streamed into Splunk or Microsoft Sentinel for audit.
  3. Platform teams that want searchable traces of agent work in CI using beacon ci exec.
  4. Teams that want repeated corrections and repo conventions distilled into Agent Skills for future agents.
  5. 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 install

On 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 | bash

On Windows, download the x64 MSI and install:

msiexec /i BeaconEndpointAgent-<version>-x64.msi

You can also hand setup to a coding agent with the prompt:

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

How 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 install

Work in Claude Code, Cursor, Codex or another harness as usual; Beacon captures in the background. Then inspect traces and token usage:

beacon traces

Or open the read-only local dashboard:

beacon endpoint dashboard

To 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 connect

Install or remove Beacon Skills:

beacon skills install
beacon skills uninstall

Check the signed-in account or disconnect the endpoint:

beacon whoami
beacon endpoint disconnect

What are this agent's strengths and limitations?

Pros
  • 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 serve stays fully local.
Limitations
  • 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?

FollowAgents source review · FARS-2.1
Major gaps
58/ 100 5-point scale 2.9 / 5
Trust 16/29
Reliability 8/14
Adaptability 12/18
Convention 12/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust16 / 29 · 2.8/5

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.

Reliability8 / 14 · 2.9/5

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.

Adaptability12 / 18 · 3.3/5

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.

Convention12 / 18 · 3.3/5

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.

Effectiveness7 / 13 · 2.7/5

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.

Verifiability3 / 8 · 1.9/5

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.

Risks and how to mitigate them
  • 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.
Evidence confidence: Low Reviewed Nov 04, 2026 Reviewed revision c47b7cbda6e4
See the full review method →

FAQ

Does Beacon send my sessions to the cloud by default?
It writes to local JSONL by default. The wizard preselects Beacon Cloud, but the confirm screen names the account, operator, destination and capture mode; choosing Local keeps everything on the machine, and beacon endpoint disconnect stops forwarding at any time.
Which coding agents are supported?
The README lists Antigravity CLI, Claude Code, Cursor, Codex CLI/Desktop, Cline, Gemini CLI, GitHub Copilot CLI, OpenCode, Qwen Code, Kiro, goose and others, with the collection method and captured fields per runtime.
Is it free?
The software is MIT-licensed and usable locally for free; hosted forwarding and cloud MCP are beacon.sh services whose pricing the README does not state.
How do I capture agent traces in CI?
Use beacon ci exec, which starts a temporary local collector that records sessions, prompts, tool calls, commands and file activity for the CI job.
Can I read the data without any UI?
Yes — the underlying store is an append-only JSONL file at ~/.beacon/endpoint/logs/runtime.jsonl; the dashboard is an optional read-only view.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents