How to use Agent Beacon (Asymptote-Labs/agent-beacon): 3 use cases

3 use cases

Replay exactly what your coding agent did

Open one trace per session with prompts, tool calls, commands, edits, approvals, MCP activity and tokens.

View prompt

Using Asymptote-Labs/agent-beacon on this machine, open the trace for my last <harness> session with `beacon traces` and list every command it ran, every file it edited and every approval, with total tokens. Verify the counts against ~/.beacon/endpoint/logs/runtime.jsonl.

Send coding agent activity to your SIEM

Forward normalized agent session history to Splunk, Datadog, Elastic, Sentinel or a bucket for security review.

View prompt

Install Asymptote-Labs/agent-beacon on <machine> and forward its endpoint telemetry to <Splunk HEC endpoint or other SIEM>. Run one <harness> session, then confirm the session's prompts, commands and approvals arrive in the SIEM and match ~/.beacon/endpoint/logs/runtime.jsonl.

Quick start with Agent Beacon

Check you have what it needs: macOS with Homebrew, Linux (Debian, Ubuntu, Fedora, RHEL, Rocky or Alma, as .deb or .rpm) or Windows x64 (MSI); At least one supported harness, such as Claude Code, Codex CLI, Cursor or OpenCode; A beacon.sh sign-in only if you choose Beacon Cloud; Local needs no account.
Open Asymptote-Labs/agent-beacon on GitHub and read the README and license.
Paste Read https://beacon.sh/start.md then set me up on Beacon into your coding agent, or on macOS run brew tap asymptote-labs/tap and brew install beacon
Run beacon endpoint install and pick Local to keep history on this machine, or confirm Beacon Cloud
Let setup install the Beacon Skills into ~/.agents/skills and ~/.claude/skills, or add them later with beacon skills install
Use Claude Code, Codex or Cursor normally while Beacon captures session history in the background

These steps come from our top use case, Share memory between Claude Code, Codex and Cursor, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for Asymptote-Labs/agent-beacon

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Agent Beacon alternatives · Best AI repos for Software and DevOps

About this repo

Who it is forDevelopers who switch between coding agents and want what one agent learned to carry over, plus security teams who need a record of what agents actually did.
Why it is hot2.8k stars, talked about in 2 AI sources we track
LanguageGo
Sourcegithub.com/Asymptote-Labs/agent-beacon · Back to Hot repos

Requirements

macOS with Homebrew, Linux (Debian, Ubuntu, Fedora, RHEL, Rocky or Alma, as .deb or .rpm) or Windows x64 (MSI)
At least one supported harness, such as Claude Code, Codex CLI, Cursor or OpenCode
A beacon.sh sign-in only if you choose Beacon Cloud; Local needs no account
For forwarding: an existing destination such as Splunk HEC, Datadog, Elastic, Microsoft Sentinel or an S3 or GCS bucket

Add this badge to your README

Maintain Agent Beacon? Show readers where to find these use cases.

Markdown

[![Use cases on Deduped](https://dedupedai.com/badge/Asymptote-Labs/agent-beacon.svg)](https://dedupedai.com/use-cases/asymptote-labs-agent-beacon/?utm_source=github&utm_medium=badge&utm_campaign=Asymptote-Labs-agent-beacon)

HTML

<a href="https://dedupedai.com/use-cases/asymptote-labs-agent-beacon/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=Asymptote-Labs-agent-beacon"><img src="https://dedupedai.com/badge/Asymptote-Labs/agent-beacon.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Agent Beacon

What is Agent Beacon?

Beacon is an open-source, local-first memory layer for AI coding agents. It captures session history from Claude Code, Cursor, Codex, OpenCode, Cline and 20+ other harnesses into one OpenTelemetry-based trace format, then turns useful workflows, corrections and debugging patterns into reviewed knowledge that future agents retrieve through MCP or Agent Skills. It is an open-source project on GitHub: https://github.com/Asymptote-Labs/agent-beacon.

How do I use Agent Beacon?

Paste Read https://beacon.sh/start.md then set me up on Beacon into your coding agent, or on macOS run brew tap asymptote-labs/tap and brew install beacon; then run beacon endpoint install and pick Local to keep history on this machine, or confirm Beacon Cloud; let setup install the Beacon Skills into ~/.agents/skills and ~/.claude/skills, or add them later with beacon skills install. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Agent Beacon for?

Developers who switch between coding agents and want what one agent learned to carry over, plus security teams who need a record of what agents actually did.

What can I do with Agent Beacon?

3 use cases so far, for example: Share memory between Claude Code, Codex and Cursor; Replay exactly what your coding agent did; Send coding agent activity to your SIEM. Each has steps and a copy-paste agent prompt.

What do I need to run Agent Beacon?

macOS with Homebrew, Linux (Debian, Ubuntu, Fedora, RHEL, Rocky or Alma, as .deb or .rpm) or Windows x64 (MSI); At least one supported harness, such as Claude Code, Codex CLI, Cursor or OpenCode; A beacon.sh sign-in only if you choose Beacon Cloud; Local needs no account; For forwarding: an existing destination such as Splunk HEC, Datadog, Elastic, Microsoft Sentinel or an S3 or GCS bucket.

What are alternatives to Agent Beacon?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Agent Beacon safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.