Skip to main content

bellwether login

Authenticate with Bellwether Cloud.

Synopsis​

bellwether login [options]

Description​

The login command authenticates you with Bellwether Cloud, enabling baseline syncing and history tracking.

Options​

OptionDescription
--token <token>Use a token directly instead of browser login
--statusCheck current authentication status
--logoutLog out and clear stored credentials

Examples​

Interactive Login​

bellwether login

This opens your browser for authentication. After logging in, credentials are stored locally.

Login with Token​

For CI/CD or headless environments:

bellwether login --token iqt_xxx

Check Status​

bellwether login --status

Output:

Logged in as: user@example.com
Plan: pro
Token expires: 2026-02-12

Logout​

bellwether login --logout

CI/CD Usage​

For CI/CD pipelines, use the BELLWETHER_SESSION environment variable instead of interactive login:

# Get your session token
bellwether login --status
# Copy the BELLWETHER_SESSION value

# In CI
export BELLWETHER_SESSION=iqt_xxx
bellwether upload --ci

Or in GitHub Actions:

env:
  BELLWETHER_SESSION: ${{ secrets.BELLWETHER_SESSION }}

Credential Storage​

Credentials are stored in ~/.bellwether/auth.json:

{
  "token": "iqt_xxx",
  "expiresAt": "2026-02-12T00:00:00Z",
  "user": {
    "email": "user@example.com"
  }
}
warning

Never commit auth.json to version control.

See Also​