CLI Authentication

Link the Azath CLI to your account to sync findings to the web dashboard, enable team collaboration, and unlock Pro features.

Login

Run the login command from any directory:

azath auth login

This opens your browser to complete OAuth authentication via GitHub or Google. After authorizing, a CLI token is created and stored securely on your device.

Named Devices

Optionally name your device to identify it in the dashboard:

azath auth login --device-name "My Work Laptop"

Check Auth Status

# Check if authenticated
azath auth status

# View current account
azath auth whoami

Logout

Revoke the current device token and sign out:

azath auth logout

◈ Token Security

CLI tokens are stored in your system keyring (macOS Keychain, Windows Credential Store, libsecret on Linux). Each device gets its own token — revoke individual devices from the dashboard without affecting others.

CI/CD Environments

For non-interactive environments, use an environment variable:

# Set token via environment variable
export AZATH_TOKEN=your_cli_token_here

# Azath will automatically use this token
azath scan -ai

Generate a CI token from your dashboard under Profile → CLI Tokens → New Token.

Managing Tokens

View and revoke all active device tokens from the web dashboard:

→ Profile → CLI Tokens