Skip to main content

​
Command Overview

Display the version number, git commit, and build date of the Agent Beacon CLI, or check whether a newer released version is available.
Command syntax
beacon version
Example output
$ beacon version

beacon version 0.0.50 (ad23164) built on 2026-06-09T20:51:00Z

​
beacon version check

Check GitHub releases for the latest published Beacon CLI version:
Check GitHub releases for the latest published Beacon CLI version
beacon version check
When an update is available, Beacon prints the latest version, the installed version, Homebrew upgrade guidance, and a release download URL.
Example output
$ beacon version check

Beacon v0.0.50 is available. Current version: v0.0.49
If installed with Homebrew: brew upgrade beacon
Download: https://github.com/Asymptote-Labs/agent-beacon/releases/tag/v0.0.50
For development builds or versions that cannot be compared with published releases, Beacon prints an informational message and exits successfully.

​
Flags

FlagDescription
-h, --helpHelp for version
-v, --versionAlso available as beacon -v at the top level

​
Upgrade

Use beacon version check before upgrading to confirm whether a newer release is available:
Use beacon version check before upgrading to confirm whether a newer release is available
beacon version check
brew update
brew upgrade beacon

Endpoint agent

Install, repair, and inspect the endpoint agent.

Upgrade Beacon

Check for updates and upgrade the Beacon CLI.