beacon login

Log in to the Asymptote dashboard from the Beacon CLI

Command Overview

Authenticate the Beacon CLI with your Asymptote dashboard account. The command opens a browser-based authorization flow and saves credentials for Beacon features that need dashboard access.

Command syntax

beacon login [flags]

Example output

Example output

$ beacon login

Opening browser to https://asymptotelabs.ai/cli/auth...
Waiting for authentication...

Success! Logged in as [e-mail]
Organization: Acme Corp

Beacon endpoint telemetry remains local-only unless you explicitly use cloud features.

If the browser cannot be opened automatically, Beacon prints the authorization URL so you can open it manually.

Credentials are stored in ~/.beacon/auth/credentials.json with user-only file permissions.

Logging in does not change local endpoint telemetry collection. Beacon endpoint telemetry remains local-only unless you explicitly configure cloud features.

Existing sessions

When valid credentials already exist, beacon login prints the saved account and organization instead of replacing them:

Existing session

$ beacon login
Already logged in as [e-mail]
Organization: Acme Corp
Run 'beacon login --force' to log in as a different user.

Use --force when you need to replace saved credentials.

Flags

Flag	Description
--dashboard-url <url>	Asymptote dashboard URL. Defaults to https://asymptotelabs.ai, or the value of BEACON_DASHBOARD_URL.
--force	Replace existing saved credentials.
-h, --help	Help for login

Related

beacon cloud

Configure cloud-agent telemetry features that may use dashboard authentication.

beacon version

Check your installed Beacon CLI version.