auth

Manage authentication for the Sentry CLI.

Commands

sentry auth login

Authenticate with Sentry.

# OAuth device flow (recommended)
sentry auth login

# Using an API token
sentry auth login --token YOUR_TOKEN

Options:

Option	Description
--token <token>	Use an API token instead of OAuth

OAuth Flow:

1. Run sentry auth login
2. A URL and code will be displayed
3. Open the URL in your browser
4. Enter the code when prompted
5. Authorize the application
6. The CLI automatically receives your token

sentry auth logout

Remove stored credentials.

sentry auth logout

sentry auth status

Check your authentication status.

sentry auth status

Output:

Authenticated as: username
Organization: my-org
Token expires: 2024-12-31

sentry auth refresh

Refresh your OAuth token.

sentry auth refresh

This is typically handled automatically when tokens expire.

Configuration

Credentials are stored in ~/.sentry/config.json with restricted file permissions (mode 600).

Config structure:

{
  "auth": {
    "token": "...",
    "refreshToken": "...",
    "expiresAt": "2024-12-31T00:00:00Z"
  }
}