Skip to content
Back to search

beacon

Beacon plugins for AI coding agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Asymptote-Labs/agent-beacon with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Asymptote-Labs/agent-beacon'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/asymptote-labs--agent-beacon/badge.svg)](/listings/asymptote-labs--agent-beacon)

HTML

<a href="/listings/asymptote-labs--agent-beacon"><img src="/api/listings/asymptote-labs--agent-beacon/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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. System, package, MDM, and CI installation paths remain noninteractive and account-free.

1. Install Beacon

<details open> <summary><strong>macOS</strong></summary>

brew trust asymptote-labs/tap
brew tap asymptote-labs/tap
brew install beacon

beacon endpoint install

</details>

<details> <summary><strong>Linux</strong></summary>

Install the latest `.deb` or `.rpm` for your distribution and architecture (Debian, Ubuntu, Fedora, RHEL, Rocky, Alma):

curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bash

The [installer](packaging/linux/install.sh) downloads the package for your architecture, verifies it against the release `checksums.txt`, and installs it with `apt-get` or `dnf`. Set `BEACON_VERSION=<version>` to install a specific release.

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

curl -fsSLO https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh
less install.sh
bash install.sh

Or skip the script and run its steps yourself: pick a version, download the package and `checksums.txt`, verify the package, and install it with your package manager.

VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/asymptote-labs/agent-beacon/releases/latest)"; VERSION="${VERSION##*/v}"
case "$(uname -m)" in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac
FORMAT=deb   # or rpm for Fedora, RHEL, Rocky, Alma
PKG="beacon_${VERSION}_linux_${ARCH}.${FORMAT}"
BASE="https://github.com/asymptote-labs/agent-beacon/releases/download/v${VERSION}"

# Download into a directory APT can read. A package in your home directory still
# installs, but APT ends with a harmless "Permission denied" notice.
DIR="$(mktemp -d /tmp/beacon-install.XXXXXXXX)" && chmod 0711 "$DIR" && cd "$DIR"
curl -fsSLO "${BASE}/${PKG}" && curl -fsSLO "${BASE}/checksums.txt" && chmod 0644 "${PKG}"
grep "  ${PKG}$" checksums.txt | sha256sum --check - && \
sudo apt install "./${PKG}"   # or: sudo dnf install "./${PKG}"

`checksums.txt` is published with the release, so it catches a corrupted or swapped download but does not prove who built the release. To check that, verify the package's build-provenance attestation, which shows it was built by this repository's release workflow: `gh attestation verify "${PKG}" --repo asymptote-labs/agent-beacon`. You can also pin `VERSION` to a release you have reviewed instead of following `latest`. To install without root, use the tarball in user mode ([Linux install guide](https://docs.asymptotelabs.ai/platforms/linux#without-root-or-without-a-package-manager)).

</details>

<details> <summary><strong>Windows</strong></summary>

Download the x64 MSI from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest).

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

For silent installation:

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

</details>

2. Use your agents normally

Open Claude Code, Cursor, Codex, or any other supported harness.

Beacon continuously captures your session history in the background

3. Explore your history

beacon traces

This opens a local terminal browser for traces, event timelines, token usage, and retained content. Nothing is sent anywhere. To use the local web view instead:

beacon endpoint dashboard

Or inspect the raw event stream:

~/.beacon/endpoint/logs/runtime.jsonl

> [!NOTE] > Signing in does not enable forwarding. Confirming the preselected Beacon Cloud

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "beacon",
  3. "owner": {
  4. "name": "Asymptote Labs",
  5. "url": "https://beacon.sh"
  6. },
  7. "description": "Beacon plugins for AI coding agents.",
  8. "plugins": [
  9. {
  10. "name": "beacon",
  11. "source": "./agent-skills",
  12. "description": "Cross-harness memory from Beacon traces: recall reviewed project lessons, distill agent sessions into approved memory, promote memory to Agent Skills, build dashboard lenses, and share sessions to beacon.sh.",
  13. "version": "0.1.0",
  14. "category": "productivity",
  15. "tags": ["memory", "traces", "observability"]
  16. }
  17. ]
  18. }
README.md · README · 475 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="images/beacon-lockup-light-mode.svg#gh-light-mode-only" alt="Beacon" width="480">
  3. <img src="images/beacon-lockup-dark-mode.svg#gh-dark-mode-only" alt="Beacon" width="480">
  4. </p>
  5. <h1 align="center">Self‑improving memory for coding agents</h1>
  6. <p align="center">
  7. <a href="https://github.com/asymptote-labs/agent-beacon/releases"><img src="https://img.shields.io/github/v/release/asymptote-labs/agent-beacon" alt="GitHub release"></a>
  8. <a href="https://github.com/asymptote-labs/homebrew-tap"><img src="https://img.shields.io/badge/homebrew-beacon-fbb040?logo=homebrew" alt="Homebrew"></a>
  9. <a href="https://github.com/asymptote-labs/agent-beacon/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/asymptote-labs/agent-beacon/ci.yml" alt="GitHub Workflow Status"></a>
  10. <a href="https://github.com/asymptote-labs/agent-beacon/blob/main/LICENSE"><img src="https://img.shields.io/github/license/asymptote-labs/agent-beacon" alt="MIT license"></a>
  11. <a href="https://docs.beacon.sh"><img src="https://img.shields.io/badge/docs-beacon.sh-0369a1" alt="Docs"></a>
  12. <a href="https://discord.gg/zdNChS2fBu"><img src="https://img.shields.io/badge/discord-community-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
  13. </p>
  14. <p align="center">
  15. <a href="https://beacon.sh">Website</a>
  16. ·
  17. <a href="https://docs.beacon.sh">Docs</a>
  18. ·
  19. <a href="https://discord.gg/zdNChS2fBu">Discord</a>
  20. ·
  21. <a href="https://docs.beacon.sh/cli/install">Install</a>
  22. ·
  23. <a href="https://docs.beacon.sh/cli">Commands</a>
  24. </p>
  25. <p align="center">
  26. <a href="https://trendshift.io/repositories/30512?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-30512" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/30512" alt="Asymptote-Labs%2Fagent-beacon | Trendshift" width="250" height="55" /></a>
  27. <a href="https://www.producthunt.com/products/asymptotelabs?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-beacon-sh" target="_blank" rel="noopener noreferrer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=dark&period=daily&t=1793685827673" /><source media="(prefers-color-scheme: light)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=neutral&period=daily&t=1793685827673" /><img alt="beacon.sh - Open-source self-improving memory for AI coding agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=neutral&period=daily&t=1793685827673" /></picture></a>
  28. <a href="https://www.producthunt.com/products/asymptotelabs?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-beacon-sh" target="_blank" rel="noopener noreferrer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=dark&period=weekly&t=1794218691353" /><source media="(prefers-color-scheme: light)" srcset="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=neutral&period=weekly&t=1794218691353" /><img alt="beacon.sh - Open-source self-improving memory for AI coding agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1292351&theme=neutral&period=weekly&t=1794218691353" /></picture></a>
  29. </p>
  30. ⭐ *Help us reach more developers and grow the Beacon community. Star this repo!*
  31. 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.
  32. **A problem solved by one agent shouldn't need to be learned from scratch by another.**
  33. ---
  34. ## Beacon Overview
  35. 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.
  36. **Key Capabilities:**
  37. - **Cross-harness history** - sessions from Claude Code, Cursor, Codex, OpenCode, Cline, and 20+ harnesses in one place
  38. - **Knowledge that compounds** - workflows, corrections, debugging patterns, and repo conventions that survive beyond a single session
  39. - **Shared agent memory** - reviewed knowledge future agents can retrieve through MCP or Agent Skills
  40. - **Exact session replay** - prompts, responses, tools, commands, edits, approvals, MCP activity, and tokens in one trace
  41. - **Local-first portability** - durable JSONL, explicit destinations, and no harness lock-in
  42. ---
  43. ## 🎬 Demo
  44. https://github.com/user-attachments/assets/38995612-84e9-4989-a905-0099f77955f0
  45. ---
  46. ## 🚀 Quick Start
  47. Beacon is open source and local-first. Interactive endpoint setup signs in through
  48. beacon.sh and preselects Beacon Cloud, with an explicit Local opt-out. Signing in
  49. forwards nothing; confirming Managed installs Beacon and connects this machine in
  50. the same command, and the confirm screen says so before you accept. Setup then ends
  51. on a short summary and opens the hosted dashboard at
  52. [beacon.sh/dashboard](https://beacon.sh/dashboard). System, package, MDM, and CI
  53. installation paths remain noninteractive and account-free.
  54. ### 1. Install Beacon
  55. **Copy & paste setup prompt into your coding agent**
  56. ```text
  57. Read https://beacon.sh/start.md then set me up on Beacon
  58. ```
  59. <details open>
  60. <summary><strong>macOS</strong></summary>
  61. ```bash
  62. brew update
  63. brew trust asymptote-labs/tap
  64. brew tap asymptote-labs/tap
  65. brew install beacon
  66. beacon endpoint install
  67. ```
  68. </details>
  69. <details>
  70. <summary><strong>Linux</strong></summary>
  71. Install the latest `.deb` or `.rpm` for your distribution and architecture (Debian, Ubuntu, Fedora, RHEL, Rocky, Alma):
  72. ```bash
  73. curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bash
  74. ```
  75. The [installer](packaging/linux/install.sh) downloads the package for your architecture, verifies it against the release `checksums.txt`, and installs it with `apt-get` or `dnf`. Set `BEACON_VERSION=<version>` to install a specific release.
  76. **Prefer not to pipe a script into your shell?** Either read the script before you run it:
  77. ```bash
  78. curl -fsSLO https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh
  79. less install.sh
  80. bash install.sh
  81. ```
  82. Or skip the script and run its steps yourself: pick a version, download the package and `checksums.txt`, verify the package, and install it with your package manager.
  83. ```bash
  84. VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/asymptote-labs/agent-beacon/releases/latest)"; VERSION="${VERSION##*/v}"
  85. case "$(uname -m)" in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac
  86. FORMAT=deb # or rpm for Fedora, RHEL, Rocky, Alma
  87. PKG="beacon_${VERSION}_linux_${ARCH}.${FORMAT}"
  88. BASE="https://github.com/asymptote-labs/agent-beacon/releases/download/v${VERSION}"
  89. # Download into a directory APT can read. A package in your home directory still
  90. # installs, but APT ends with a harmless "Permission denied" notice.
  91. DIR="$(mktemp -d /tmp/beacon-install.XXXXXXXX)" && chmod 0711 "$DIR" && cd "$DIR"
  92. curl -fsSLO "${BASE}/${PKG}" && curl -fsSLO "${BASE}/checksums.txt" && chmod 0644 "${PKG}"
  93. grep " ${PKG}$" checksums.txt | sha256sum --check - && \
  94. sudo apt install "./${PKG}" # or: sudo dnf install "./${PKG}"
  95. ```
  96. `checksums.txt` on its own catches a corrupted download but does not prove who built the release. From 1.3.57 on, `checksums.txt.sig` signs it with Beacon's Linux release key (fingerprint `07BEA34ED6A411F4C066D98322F94195DCDC8F45`), which `install.sh` checks; the [Linux install guide](https://docs.asymptotelabs.ai/platforms/linux#release-signing) shows how to check it by hand and how to install from the signed apt repository instead. You can also verify the package's build-provenance attestation, which shows it was built by this repository's release workflow: `gh attestation verify "${PKG}" --repo asymptote-labs/agent-beacon`. You can also pin `VERSION` to a release you have reviewed instead of following `latest`. To install without root, use the tarball in user mode ([Linux install guide](https://docs.asymptotelabs.ai/platforms/linux#without-root-or-without-a-package-manager)).
  97. </details>
  98. <details>
  99. <summary><strong>Windows</strong></summary>
  100. Download the x64 MSI from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest).
  101. ```bash
  102. msiexec /i BeaconEndpointAgent-<version>-x64.msi
  103. ```
  104. For silent installation:
  105. ```bash
  106. msiexec /i BeaconEndpointAgent-<version>-x64.msi /qn
  107. ```
  108. </details>
  109. ### 2. Use your agents normally
  110. Open Claude Code, Cursor, Codex, or any other supported harness.
  111. Beacon continuously captures your session history in the background
  112. ### 3. Explore your history
  113. ```bash
  114. beacon traces
  115. ```
  116. This opens a local terminal browser for traces, event timelines, token usage, and retained content. Nothing is sent anywhere. To use the local web view instead:
  117. ```bash
  118. beacon endpoint dashboard
  119. ```
  120. Or inspect the raw event stream:
  121. ```text
  122. ~/.beacon/endpoint/logs/runtime.jsonl
  123. ```
  124. > [!NOTE]
  125. > Signing in does not enable forwarding. Confirming the preselected Beacon Cloud
  126. > option does: the confirm screen names the signed-in account, states that
  127. > confirming installs Beacon and starts forwarding, names Asymptote Labs as the
  128. > operator, the destination, and the capture mode, and connects the endpoint
  129. > after the install succeeds. Choose Local to keep everything on this machine,
  130. > and disconnect any time with `beacon endpoint disconnect`.
  131. Whichever destination you choose, the wizard also installs the
  132. [Beacon Skills](https://docs.beacon.sh/concepts/beacon-skills) into `~/.agents/skills`
  133. and `~/.claude/skills` unless you turn them off; redo or undo that with
  134. `beacon skills install|uninstall`.
  135. If you choose Beacon Cloud, the wizard also registers Beacon Cloud MCP in your harnesses
  136. unless you turn it off, so your agents can search the forwarded history. To do it later,
  137. or for an endpoint connected another way:
  138. ```bash
  139. beacon mcp connect
  140. ```
  141. This registers the `beacon-managed` MCP server in Claude Code, Codex CLI, Cursor, VS Code, Gemini CLI, and OpenCode, and each harness signs in with OAuth the first time it connects. No token is written. `beacon mcp disconnect` removes exactly what it added. The local `beacon` MCP server (`beacon mcp serve`) is separate and never touches the network. See [`beacon mcp connect`](https://docs.beacon.sh/cli/mcp-connect).
  142. Inspect the account used during interactive setup:
  143. ```bash
  144. beacon whoami
  145. ```
  146. ---
  147. ## 🧠 Turn Session History Into Memory
  148. Every agent session contains potentially useful knowledge about your codebase.
  149. Beacon creates a loop around that history:
  150. ```text
  151. Run agents
  152. ↓
  153. Capture session history
  154. ↓
  155. Evaluate what worked
  156. ↓
  157. Extract useful knowledge
  158. ↓
  159. Review + approve
  160. ↓
  161. Reuse across future agents
  162. ```
  163. That could be:
  164. - the right way to run a migration
  165. - a debugging path that finally fixed an obscure issue
  166. - a testing convention agents repeatedly get wrong
  167. - a repository-specific workflow
  168. - the right sequence of internal tools
  169. - a correction you've given multiple agents
  170. Instead of disappearing into old sessions, that knowledge becomes reusable.
  171. ---
  172. ## 🔀 Cross-Harness by Design
  173. Most agent memory belongs to a single harness.
  174. Beacon sits across the harness layer.
  175. ```text
  176. Claude Code ─┐
  177. Cursor ──────┤
  178. Codex ───────┼──→ Beacon ──→ shared project knowledge
  179. OpenCode ────┤
  180. Cline ───────┘
  181. ```
  182. Because Beacon captures and normalizes session history across tools, knowledge learned through Claude Code doesn't have to stay in Claude Code.
  183. Your Cursor sessions can improve Codex.
  184. Your Codex sessions can improve OpenCode.
  185. Your history keeps compounding even as you switch tools.
  186. **Your agent session history belongs to you, not the harness.**
  187. ---
  188. ## 🔎 One Trace Format for Every Agent
  189. Beacon captures agent execution where it happens and normalizes it into a common OpenTelemetry-based event model.
  190. That includes:
  191. - sessions
  192. - prompts and responses
  193. - tool calls
  194. - commands
  195. - file activity
  196. - approvals
  197. - MCP interactions
  198. - token usage
  199. Instead of separate proprietary histories for every coding tool, you get one dataset you can inspect, search, learn from, and build on.
  200. ---
  201. ## 🖥️ Local Dashboard
  202. Beacon ships with a local, read-only dashboard:
  203. ```bash
  204. beacon endpoint dashboard
  205. ```
  206. Use it to explore session history across harnesses and understand what your agents actually did.
  207. Open the URL it prints: it carries a secret for that run, so other accounts on a shared machine
  208. cannot read your log through the port. Administrators can turn the dashboard off for everyone
  209. with `beacon endpoint install|repair --system --dashboard disabled` (`BEACON_DASHBOARD=disabled`
  210. for package installs).
  211. Each session page can also show **lenses**: purpose-built views of one trace, such as files
  212. changed with their diffs, an itemized token bill, a security review grouped by risk, or the
  213. approval timeline. A lens is a single HTML file running in a sandboxed frame with no access to
  214. Beacon or the dashboard and no ordinary network APIs, so you can have your coding agent write
  215. your own (`beacon lenses spec`, `lint`, `preview`, `add`). The sandbox cannot block every way a
  216. browser can send data out, so install only lenses you trust with your traces. See
  217. [Lenses](https://docs.beacon.sh/concepts/lenses).
  218. The underlying JSONL remains directly accessible, so you're never dependent on the UI.
  219. ---
  220. ## Supported Agents
  221. Beacon supports local agents, browser agents, cloud agents, CI workflows, and agent SDKs.
  222. ### Local Agent Coverage
  223. | Runtime | Collection | Session | Prompt | Tool | Command | File | Approval | MCP | Tokens | Skills |
  224. | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
  225. | Antigravity CLI | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ skills CLI |
  226. | Claude Code | OTLP + hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ Plugin |
  227. | Claude Cowork | OTLP | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ Plugin |
  228. | Cline | Plugin + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `.cline/skills` |
  229. | Codex CLI | OTLP + hooks + poll | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ | ✅ Plugin |
  230. | Codex Desktop | OTLP | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ | ✅ Plugin |
  231. | Cursor | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ Plugin |
  232. | DeepSeek Harness | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `.agents/skills` |
  233. | Devin CLI | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ Plugin |
  234. | Devin Desktop | Hooks | – | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ via Devin CLI |
  235. | Factory Droid | OTLP + hooks + poll | ✅ | ✅ | ✅ | – | ✅ | ✅ | – | – | ✅ Plugin |
  236. | fx (Vercel Labs) | Poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `/skills install` |
  237. | Gemini CLI | OTLP | – | ✅ | ✅ | – | ✅ | ✅ | ✅ | – | ✅ `gemini skills install` |
  238. | GitHub Copilot CLI | OTLP + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ Plugin |
  239. | goose | Adapter only; manual hooks/OTLP | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ skills CLI |
  240. | Grok Build | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ Plugin |
  241. | Hermes Agent | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ `hermes skills install` |
  242. | Kimi Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ Plugin |
  243. | Kiro | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ Power |
  244. | Muse Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ `.agents/skills` |
  245. | Oh My Pi | Extension | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ Plugin |
  246. | OpenClaw Gateway | Plugin + OTLP + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ~ | ✅ Plugin |
  247. | OpenCode | Plugin + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ skills CLI |
  248. | OpenHands | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ skills CLI |
  249. | Pi | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ Package |
  250. | Prime Agent | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ Package |
  251. | Qwen Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ Plugin |
  252. | Senpi | Extension | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ `.agents/skills` |
  253. | VS Code | OTLP + hooks | ✅ | ✅ | ✅ | ~ | ~ | – | ~ | – | ✅ Plugin |
  254. **Skills** shows how to install [Beacon Skills](https://docs.beacon.sh/concepts/beacon-skills), the Agent Skills that recall and distill project memory from these traces. Every runtime above loads Agent Skills:
  255. - **Plugin**: install the `beacon` plugin from this repository's marketplace, for example `/plugin marketplace add asymptote-labs/agent-beacon` in Claude Code.
  256. - **Package** (Pi, Prime Agent): `pi install git:github.com/asymptote-labs/agent-beacon`.
  257. - **Power** (Kiro): import `https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills` from the Powers panel.
  258. - **skills CLI**: `npx skills add asymptote-labs/agent-beacon`, optionally with `-a <agent>`.
  259. - **A directory**: copy `agent-skills/skills/*` into that project directory.
  260. The [Beacon Skills page](https://docs.beacon.sh/concepts/beacon-skills#install) has the exact command for each runtime.
  261. ### Browser Chat
  262. | Site | Collection | Prompt | Response | Tool | Tokens |
  263. | --- | --- | --- | --- | --- | --- |
  264. | Claude.ai | Chromium + Firefox extension → local OTLP | ✅ | ✅ | ✅ | ~ |
  265. | ChatGPT | Chromium + Firefox extension → local OTLP | ✅ | ✅ | ✅ | – |
  266. ### Cloud Agents
  267. | Runtime | Collection | Session | Prompt | Tool | Command | File | Tokens |
  268. | --- | --- | --- | --- | --- | --- | --- | --- |
  269. | Claude Code Cloud Agents | Sandbox hooks → GCS or S3 | ✅ | ✅ | ✅ | ✅ | ✅ | – |
  270. | Cursor Cloud Agents | Sandbox hooks → GCS or S3 | – | ✅ | ✅ | ✅ | ✅ | – |
  271. | Devin Cloud Agents | API poll → GCS | ✅ | ✅ | – | – | – | ✅ |
  272. | CI jobs | `beacon ci exec` → temporary local collector | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
  273. ### SDK Instrumentation
  274. | SDK Surface | Collection | Captures |
  275. | --- | --- | --- |
  276. | Anthropic | OpenLLMetry through `@asymptote/sdk` | Model call spans, errors, and OTel attributes |
  277. | OpenAI | OpenLLMetry through `@asymptote/sdk` | Model call spans, errors, and OTel attributes |
  278. | Claude Agent SDK | `Observe.wrapClaudeAgentQuery()` | Query root spans with Beacon-compatible prompt attributes |
  279. | Vercel AI SDK | `experimental_telemetry` tracer handoff | Model call and tool spans where telemetry is enabled |
  280. ### LLM Gateways
  281. | Gateway | Collection | Captures |
  282. | --- | --- | --- |
  283. | LiteLLM, Envoy (incl. Envoy Gateway, Istio), Portkey | [`beacon-gateway`](gateway/README.md) hook adapter | Prompts, responses, tool calls, and token usage for every model call routed through the gateway |
  284. ---
  285. ## Output Destinations
  286. Beacon writes endpoint telemetry to local JSONL by default.
  287. You can also forward the same normalized session history into infrastructure you already use:
  288. **Splunk · Datadog · Elastic · Microsoft Sentinel · CrowdStrike Falcon LogScale · Sumo Logic · Wazuh · AWS S3 · GCS · CloudWatch**
  289. | Destination | Category | Support Path |
  290. | --- | --- | --- |
  291. | Local JSONL | Local | Default endpoint log and local dashboard source |
  292. | Beacon Cloud | Hosted forwarding | Signed-in device enrollment with Standard or Metadata-only privacy |
  293. | CrowdStrike Falcon LogScale HEC | SIEM | Endpoint forwarding with LogScale ingest tokens |
  294. | Microsoft Sentinel | SIEM | Azure Monitor Agent and Data Collection Rule content pack |
  295. | Rapid7 InsightIDR | SIEM | Custom Logs webhook content pack |
  296. | Splunk HEC | SIEM | Endpoint forwarding during install or repair |
  297. | Sumo Logic | SIEM | HTTP Logs & Metrics Source content pack |
  298. | Wazuh | SIEM | Localfile configuration and Beacon content pack |
  299. | AWS CloudWatch Logs | Log aggregation | Vector content pack |
  300. | Datadog | Log aggregation | Datadog Agent custom log collection |
  301. | Elastic | Log aggregation | Filebeat or Elastic Agent |
  302. | Customer-managed pipelines | Log aggregation | Forward directly from local Beacon JSONL |
  303. | AWS S3 | Object storage | Vector, CI upload, or cloud-agent snapshots |
  304. | Google Cloud Storage | Object storage | Vector, CI upload, or cloud-agent snapshots |
  305. ---
  306. ## Architecture
  307. Beacon captures activity where agents actually run and normalizes it into one shared event model.
  308. ```text
  309. Local agents ───────┐
  310. Browser chat ───────┤
  311. CI ─────────────────┼──→ Beacon ──→ unified session history
  312. Cloud agents ───────┤ │
  313. Agent SDKs ─────────┤ ├──→ local JSONL
  314. LLM gateways ───────┘ │
  315. ├──→ reviewed memory
  316. ├──→ MCP / Agent Skills
  317. └──→ your own infrastructure
  318. ```
  319. See the [documentation](https://docs.beacon.sh/architecture/architecture) for the full architecture breakdown.
  320. ---
  321. ## Documentation
  322. Read the docs for:
  323. - installation
  324. - supported runtimes
  325. - event schema
  326. - session history
  327. - memory
  328. - MCP
  329. - Agent Skills
  330. - forwarding
  331. - advanced configuration
  332. [**Read the docs →**](https://docs.beacon.sh)
  333. ---
  334. ## Contributing
  335. Contributions are welcome.
  336. Open an issue, submit a pull request, or join the [Discord](https://discord.gg/zdNChS2fBu).
  337. ---
  338. ## License
  339. [MIT](LICENSE)
  340. ## Star History
  341. <a href="https://www.star-history.com/?repos=asymptote-labs%2Fagent-beacon&type=date&legend=top-left">
  342. <picture>
  343. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=asymptote-labs/agent-beacon&type=date&theme=dark&legend=top-left" />
  344. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=asymptote-labs/agent-beacon&type=date&legend=top-left" />
  345. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=asymptote-labs/agent-beacon&type=date&legend=top-left" />
  346. </picture>
  347. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.