Changelog
Other
- 0081319 Add ShareEventsAfter for re-shares, and the subagent relationship
- 55acb09 Add auto-share through Beacon Cloud: beacon share auto enable|disable|status
- 71af5ab Add beacon share --follow and document sharing from CI
- b62b1db Add beacon share --follow and document sharing from CI (#786)
- 2a047b9 Add beacon share and beacon share refresh
- 57e87ce Add beacon share and beacon share refresh (#781)
- d918345 Add latest release notes (#776)
- 3e7c143 Add the beacon-trace-share agent skill
- 779401c Add the beacon-trace-share agent skill (#783)
- e7bce5c Add the beacon.share.v1 contract types and session-to-message projection
- 515a1f5 Add the traces:write scope and the shared-trace API client
- 8219bd6 Add the traces:write scope and the shared-trace API client (#780)
- 4ab12ea Bump historyDerivationVersion for the new redaction rules
- aadf40d Cap pre-push sharing only on sessions this machine has
- 47d028e Carry prompt.id on trace events and type agent.response as an agent message
- 63c278c Carry share URLs in commit notes and share linked sessions on push
- 70a0f28 Carry shared-trace links in git notes and share linked sessions on push (#785)
- 1e4386a Clone a shared event before deriving its trace identity
- a7e5cd2 Compare auto-share project paths the filesystem's way; global disable turns projects off
- e7ea306 Compare the active-session directory the way session listings do
- 9118d1d Count no pushed commits for an unbounded push to a URL
- 47a07a3 Do not let a share's own events make a session shared from inside itself stale
- 456873f Do not share through a sign-in to a different service than the one named
- afd009c Document Beacon Cloud sessions, devices, lenses and MCP write access
- b68989b Document managing and deleting lenses from the dashboard Lenses page
- 9f6e1c2 End a quoted value only at its own quote; redact secret-named arrays
- e3b1c8f Find the store copy by its own listing when switching from the log
- 4f63a00 Fold the session list's sharing state in append order
- ead0b5e Give the notes push what is left of the hook's budget
- ad74cd6 Give up following a session that has nothing to share any more
- 93f42f4 Hide a share's reply only when the session itself ran the share
- d868f97 Hold push-time sharing to the clock
- c0c8319 Ignore a resumed session's old end in --follow
- 087c49b Keep Beacon's own session records out of session recency
- 8c629a9 Keep an existing shared trace's title unless --title is passed
- d173f5e Keep an existing trace's title and record what each upload covered
- f83d645 Keep escaped quotes inside a quoted value
- 2587fed Keep git's stdin for the repository's own pre-push and post-rewrite hooks
- 58e6210 Keep re-shares and refreshes on the source the trace came from
- 4031cec Keep redacted JSON parseable and widen the redaction window
- 9ba1f19 Keep self-hosted share URLs through post-rewrite normalization
- b541b02 Keep the share date when a shared trace is shared again
- 2042534 Keep the writer's sequence on the records the session list folds
- b599004 Keep token type prefixes so credential rules still match the log
- 11c7799 Leave a detached HEAD and the home directory's name out of share metadata
- 470ef38 Let --state shared include stale shares
- 642cb89 Let a repository's opt-out marker win over the user's entry
- b2ba46b Let an agent share the session it is running in (#782)
- 1c44e94 List each store once per push, and name the pre-push sharing exception
- a2b5fc3 Make the user-wide auto-share switch three-state and stop rewriting projects
- 2255670 Match beacon share only in command position; buffer only shared sessions
- e19698f Match only JWT bearers in the handoff rule's redacted form
- d09398e Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2' into HEAD
- 41279a1 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2' into HEAD
- 7d1be0d Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-account' into HEAD
- 039df35 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-account' into HEAD
- 266e5f1 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-auto' into HEAD
- e8c816c Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-auto' into HEAD
- 557f862 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-auto' into HEAD
- ea209f4 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-ci' into HEAD
- 6b1f59b Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-ci' into HEAD
- 764c2b9 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into HEAD
- 658a543 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into HEAD
- 8b34e62 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into HEAD
- 0ef9873 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into claude/affectionate-dijkstra-os6gl2-share-auto
- abc9478 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into claude/affectionate-dijkstra-os6gl2-share-current
- eae3dd4 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into claude/affectionate-dijkstra-os6gl2-share-current
- 68d8cb7 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-command' into claude/affectionate-dijkstra-os6gl2-share-current
- 6cfc248 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- bf75371 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- 95f2eb7 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- 4a3f7b1 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- 3b9db21 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- fb3efbd Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-current' into HEAD
- 42fb363 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-git' into HEAD
- 79050de Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-git' into HEAD
- e95820b Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-skill' into HEAD
- 5d368a4 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-skill' into HEAD
- b4e9457 Merge remote-tracking branch 'origin/claude/affectionate-dijkstra-os6gl2-share-skill' into HEAD
- d454a8d Merge remote-tracking branch 'origin/main' into HEAD
- 26a3214 Merge remote-tracking branch 'origin/main' into HEAD
- 84c226e Merge remote-tracking branch 'origin/main' into HEAD
- 4685e14 Merge remote-tracking branch 'origin/main' into claude/great-noether-p1ytww
- 709a67d Merge remote-tracking branch 'origin/main' into claude/youthful-bell-56xms8
- 0effb7a Merge the share-command fixes, and use the active entry only when it is newest
- 65e23e5 Merge the trace.v1 contract into the local sharing views
- 3cdb743 Merge the trace.v1 share contract into auto-share
- 380b1b1 Merge the trace.v1 share contract into git push sharing
- f68941b Merge the trace.v1 share contract into share --follow
- 74581e8 Move the trace projection into pkg/asymptoteobserve
- 6c0bf5a Name the MCP Access page by its sidebar location in the MCP CLI docs
- 6111064 Name the project in the trace summary and relate a handed-off share
- 556a975 Never let an event the share projection skips make a share stale
- e6b635d Pair a prompt captured without prompt.id with its keyed copy
- eb6e907 Pass quotedRules a kind, not the prefix pattern
- 6453af4 Pass the runtime to beacon share refresh in the share skill
- 4e6b9b7 Point MCP token docs at the restored MCP Access page
- c948b3d Publish only network git remotes in shared traces
- b86b04a Queue only explicit invocations to wait for a result
- fa77dec Re-send open tool calls and the last uploaded message on refresh
- cb5d7ea Read pre-push stdin only when Beacon's hook block passed a copy in
- 4ab576c Read the runtime log once per push when resolving linked sessions
- 4d9c316 Rebuild the trace history for the stricter share-call match
- 8343d97 Record each --follow upload, honor explicit --title/--visibility, fix CI advice
- 3b8fd10 Redact common credential formats and secret-named fields
- 98780de Redact common credential formats and secret-named fields (#788)
- ed266da Redact quoted command-line flag values
- 454bb27 Redact whole values and only real private key blocks
- 036882d Refuse a session id whose BEACON_HARNESS is missing or unknown
- c340f5c Refuse an ambiguous session prefix rather than share the log's match
- cf1181f Refuse an inherited BEACON_SESSION_ID that this directory contradicts
- 0ac3140 Rename RedactString's removed-copy variable
- d8ecd79 Report a failed close of the active-session lock file
- 29f6482 Report the shared trace's event count in the share skill
- e05430c Request automatic sharing through Beacon Cloud, never from hooks over the network (#784)
- c53599d Retry the final --follow upload and keep following when only the record fails
- ecec473 Rewrite home and session paths inside file:// URLs
- 6b0a396 Rewrite shared paths only where the whole path matches
- 766633b Rewrite the home path in the share title when it is passed explicitly
- e037a19 Say that Beacon Cloud forwarding runs a Beacon-managed Vector forwarder
- a4b9489 Send only network git remotes from beacon share
- aafc2ed Share a session as a beacon.trace.v1 trace and refresh by last event
- 3dab361 Share from the runtime log when a session's store cannot be read
- a8da85f Share no sessions on push when the pushed refs are unknown
- e96a0e2 Share sessions as beacon.trace.v1 and move the trace projection into pkg/asymptoteobserve (#779)
- c3fc84a Share the session an agent runs inside with beacon share --current
- d816303 Share traces as beacon.trace.v1 and derive the chat view from the bundle
- 33557a1 Show sharing state in the local dashboard and trace views (#787)
- 4c7994e Show sharing state, staleness and the refresh command in local views
- c1219e4 Stop --follow at an end the runtime log records; report read failures
- 574440a Take back the share-request mark when the request cannot be written
- a6bdd4a Treat a tool.invoked event that carries a result as the completion
- 9117c9e Treat the turn-end event after a share as the share's own
- c74d0b1 Upload shared traces as a trace.v1 summary and its events
- 50e464c Work out session sharing from every event and compare against what a share covered
- 9ef7bd7 Write a prompt captured by both the hook and the export once
- 75713c1 Write finished uploads' URLs into notes even when the upload budget runs out
- 2b9067f add docs
Installation
Homebrew (macOS/Linux)
brew tap asymptote-labs/tap
brew install beaconLinux (Debian, Ubuntu, Fedora, RHEL)
curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/download/v1.3.36/install.sh | BEACON_VERSION=1.3.36 bashManual Download
Download the appropriate archive for your platform from the assets below, extract it, and add the binary to your PATH.
Quick Start
beacon endpoint install
beacon endpoint status
beacon endpoint wazuh print-configThreat detection rules
beacon ships with a small built-in baseline. Install the full threat-rule
pack (attached as threat-rules.tar.gz below) and scan your local telemetry:
beacon rules pull https://github.com/asymptote-labs/agent-beacon/releases/download/v1.3.36/threat-rules.tar.gz
beacon rules list
beacon scan