beacon version

Display the Agent Beacon CLI version and check for updates

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

Example output

$ beacon version

beacon version 0.0.66 (c618237) built on 2026-06-13T23:01:46Z

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

Example output

$ beacon version check

Beacon v0.0.66 is available. Current version: v0.0.65
If installed with Homebrew: brew upgrade beacon
Download: https://github.com/Asymptote-Labs/agent-beacon/releases/tag/v0.0.66

For development builds or versions that cannot be compared with published releases, Beacon prints an informational message and exits successfully.

Flags

Flag	Description
-h, --help	Help for version
-v, --version	Also 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

Related

Endpoint agent

Install, repair, and inspect the endpoint agent.

Upgrade Beacon

Check for updates and upgrade the Beacon CLI.