# `bird auth status`

## Usage

```bash
bird auth status [flags]
```

## Description

Reports whether a token is configured AND whether it works. For an OAuth login it also shows the workspace/org, region, and granted scopes. Surfaces credentials-file parse errors that config.Load swallows silently. Always exits 0 — callers parse `valid` in --format json to branch. Pass --offline to skip the API call.

## Options

| Name        | Description                  |
| ----------- | ---------------------------- |
| `--offline` | Skip the API validation call |

## Related

| Name                                                              | Description                                                            |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------- |
| [`bird auth create-org`](/docs/cli/reference/auth-create-org)     | Create the first organization and workspace and mint your credential.  |
| [`bird auth login`](/docs/cli/reference/auth-login)               | Authenticate with Bird through your browser (OAuth)                    |
| [`bird auth logout`](/docs/cli/reference/auth-logout)             | Revoke the OAuth grant (if any) and remove the stored credentials file |
| [`bird auth signup`](/docs/cli/reference/auth-signup)             | Start a passwordless Bird signup and email a six-digit code.           |
| [`bird auth verify-email`](/docs/cli/reference/auth-verify-email) | Confirm the emailed six-digit code and sign in.                        |