Changelog
Features
- 7f89387 feat(mcp): push MCP servers to Claude Code and Codex users from MDM
- c0b17e1 feat(mcp): push MCP servers to Claude Code and Codex users from MDM (#1350)
- 0b4de53 feat(rules): /etc/bashrc, /etc/zlogin and /etc/csh.cshrc are startup files
- 8e17105 feat(rules): agent control and approval rules on parsed commands; dangerous_command
- 557ad80 feat(rules): agent surface writes on file_writes
- 4c1e2a6 feat(rules): approval rules ask the standalone rules' definitions
- 5a97705 feat(rules): cloud grants, database drops and teardowns on parsed commands
- 927e32e feat(rules): cloud metadata, DNS tunnel and SSH tunnel rules on parsed commands
- 0579f7c feat(rules): command rules match what a command line runs, not its text (#1320)
- f8ccd84 feat(rules): command_unread, and disk-fill-attempt on parsed commands
- b454cfa feat(rules): credential scans and fork bombs on parsed commands
- 6b9646f feat(rules): cron files, root shells, new accounts in privileged groups, and tunnels by option
- c5a9bc1 feat(rules): every text fallback asks the text that reaches a command
- c15a727 feat(rules): every text fallback asks the text that reaches a command (unread_text)
- daa8c62 feat(rules): git rules on parsed commands
- c21381f feat(rules): installs, containers, shell escapes and telemetry tampering on parsed commands
- ee2ed56 feat(rules): more startup files, pipeline stage lists, and JSON Schemas for definitions files (#1324)
- e77c693 feat(rules): one list of shell startup files, with the system-wide bash and zsh ones
- e743098 feat(rules): privilege and persistence rules on parsed commands
- 0a1b8f5 feat(rules): rules diff checks what a scan finds, and counts a new failure as a change
- 146c839 feat(rules): sensitive-file and store-read rules read the text the parser cannot see into
- c7f8ddc feat(rules): text fallbacks read what reaches a command; predicates for repeated shapes (#1330)
- f9f1056 feat(rules): text halves name what their parsed halves name
- fc6d97d feat(rules): the file-path rules also match a shell command's writes
- 3e64fa0 feat(shellcmd): a download's file and an archive's directory are writes
- 79bb8ab feat(shellcmd): a script a pipe sends a shell is read when the stage before prints it
- 343c83d feat(shellcmd): the command behind sudo -i, sudo -D, env -C and uv run --directory is read
- 619f68c feat(shellcmd): the commands an interpreter's inline script runs are listed
- ede19fd feat(threatrules): a predicate's literal pattern parts join into one literal
Bug Fixes
- 4759272 fix(dashboard): every view of findings shows failed and skipped rules
- 96e335c fix(mcp): keep a replaced file's owner and group; refuse control characters in headers
- 9c73000 fix(mcp): name pushed Codex servers org-; keep trailing comments; offboarding order
- 356850f fix(mcp): readable directories under any umask; keep comments above the next table
- c9c7b44 fix(rules): a line's own variables widen a span, and chmod's operands stay on its line
- 16e2249 fix(rules): a write is excused as scratch only when every cd of the line goes into a temporary directory
- 75a24e3 fix(rules): any read carrier feeds a credential filter, fd duplications keep stdin, and sudo -i or -s is a shell only from a terminal
- c921622 fix(rules): bound what reading a command line may cost, and fuzz the reading
- 0761cee fix(rules): carried listers feed a local filter, a directory is not a drop-in, and stdin is the command's own
- 9521107 fix(rules): dd's operands are read as written, and programs that can run a word no longer vouch for a line
- 051a7d3 fix(rules): disk-fill asks what a command writes, and git config in the environment leaves a line unread
- b6d58d2 fix(rules): disk-fill skips bounded reads and keeps the redirections the parser places elsewhere
- 85990e1 fix(rules): egress_sender drops the wrapper clause no v1.3 name can reach
- 5fffc99 fix(rules): network clients are trusted only without a way to run a program
- 44a9ced fix(rules): text halves stay on commands, and the detections main had come back
- ed78db4 fix(shellcmd): a parsed command knows the directory it runs in, so a cd after a write no longer hides it
- 569e474 fix(shellcmd): a path under /dev is judged a device only once it is cleaned
- 723d43c fix(shellcmd): a span is the pieces that reach a command, not everything since the first writer
- 2e91317 fix(shellcmd): a span widens for a variable the line names, not for a list of setters
- 44c9f22 fix(shellcmd): a wrapper's options, the test command and a program by an unevaluated path
- 6af88b8 fix(shellcmd): an arrow after a parenthesis that closes nothing panicked the script reader
- 5c45822 fix(threatrules): StepMatcher tells the steps of two packs apart
- d202a4d fix(threatrules): a rule that cannot be evaluated no longer blanks the scan
- ed7c002 fix(threatrules): bound what reading a command line costs; a failed rule no longer blanks a scan (#1323)
- ec362c9 fix(threatrules): lint fails what a scan reports failing, a diff counts what it could not compare, and the atom table is bounded again
- a6c11e9 fix(threatrules): one evaluation path; StepMatcher tells packs apart (#1329)
Other
- 3b3c961 chore(cursor): drop the committed Cursor cloud setup (#1345)
- 42111e3 docs(cloud agents): say what to do when the org blocks service account keys (#1347)
- 3309fea docs(cursor): screenshots of the Cursor cloud environment setup (#1346)
- 8bcb7b8 docs(rules): what makes a rule metered, after measuring three of them
- 8d33e43 docs(rules): what the parser reads after the gap closures
- 20169de feat(threat-rules): JSON Schemas for predicate definitions and catalogs
- 9195c7a feat(threat-rules): a predicate can bind a name for its caller; unread_text asks the text that reaches a command
- 5e6e604 feat(threat-rules): declarations are parsed commands; shred's writes (spec v1.3)
- ec3741c feat(threat-rules): file_writes, a command's writes by the path as written (spec v1.3)
- 32e4bbe feat(threat-rules): parsed_incomplete, and command_unread for a line not read to its end
- 001b0fe feat(threat-rules): read what xargs, find -exec, ssh and docker exec run; runs_read and span (spec v1.3)
- 119d7c3 perf(rules): a rule about two stages of a pipeline asks that pipeline's commands
- f4e0f79 perf(rules): allocate less to ask a pattern of a text
- c38f2e6 perf(rules): ask the rarer pattern first in two fall-back clauses
- c338fb1 perf(rules): check each expression of a pack once
- 5aea2c3 perf(rules): four rules ask one text pattern, not one per command
- 9d8e5a0 perf(rules): read a text's literals once, and compile a pattern once
- 55d547a perf(rules): telemetry-or-history-tampering asks one text pattern, not fourteen
- 899c52e perf(rules): text patterns the prefilter can skip
- 5c5ec7f perf(rules): the scratch-directory question is asked of the line, not of every write
- 288ded0 perf(rules): turn an event into CEL values once for a scan
- 9963f76 perf(rules): write command_unread and the agent rules so their cost can be bounded
- fbb6f6e perf(threatrules): a scan answers its correlation rules from one pass over the events
- aac0f5c perf(threatrules): a variable an expression binds is as large as what it is bound to
- 8e24551 perf(threatrules): an evaluation's cost is bounded by the sizes of what it reads
- 9abc892 perf(threatrules): the match cache holds the whole compiled matcher
- 36c37a5 refactor(cmd): one place says which mode --user and --system select
- fc7aad4 refactor(detect): one scan behind every findings view; field spec versions as tags (#1327)
- b671475 refactor(detect): one scan for
beacon scan, the findings page and lens findings - d25debd refactor(rules): agent_cli, one definition of a coding agent's command
- 6d2f25f refactor(rules): correlation read steps call the rule they copied
- 22d66b8 refactor(rules): egress_command, one definition of an outbound command
- 97248f5 refactor(rules): git's global options are passed over in one predicate
- 185ab76 refactor(rules): predicates for the shapes rules repeated
- b83d03c refactor(shellcmd): a command's writes are read once, as written, each marked exact or not
- bcdb3a6 refactor(shellcmd): a redirection is classified once, and a device or a descriptor is never a file
- b624ab2 refactor(shellcmd): one pipeline index answers every question about a command's other stages
- a210615 refactor(shellcmd): one program identity, one alias table, one wrapper walk
- 12f5f05 refactor(shellcmd): one program identity, one reading, and a command's working directory (#1328)
- fea5803 refactor(shellcmd): one scanner reads an inline script's code, and the docs name what it reads
- ad68848 refactor(shellcmd): shellcmd.Read is the one reading, with one outcome past every bound
- cf97303 refactor(shellcmd): what a command hands on is one value, and interpreters get stdin as shells do
- 9ccc4e9 refactor(threatrules): a field's spec version is a tag on the field, read by the gate, FIELDS.md and a docs test
- 120b8d1 refactor(threatrules): correlation has one session grouping and an explicit step table
- 8968c47 refactor(threatrules): name the four size measures, and pin the rules metered on ordinary events
- 638c296 refactor(threatrules): one function evaluates a rule on an event
- 96ce962 refactor(threatrules): one prefilter walker, and atoms numbered by the pattern table
- 0cab7aa test(rules): copies the pack has to keep are held equal
- 1a48aae test(threatrules): -update copies the corpus files over the baseline
Installation
Homebrew (macOS/Linux)
brew update
brew trust asymptote-labs/tap
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.66/install.sh | BEACON_VERSION=1.3.66 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.66/threat-rules.tar.gz
beacon rules list
beacon scan