> ## Documentation Index
> Fetch the complete documentation index at: https://docs.droyd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Reference: Authentication

> Reference for user sessions and stored OpenRouter credentials.

## User session

```text theme={null}
droyd auth login [--provider <provider>] [--no-browser]
                 [--callback-port <port>] [--json]
droyd auth status [--json]
droyd auth logout [--json]
```

`login` runs browser authorization. `--no-browser` prints the link rather than
opening it; `--callback-port` changes the local callback port. `status` reports
whether the CLI is authenticated and the credential source. `logout` clears
the stored CLI session.

## Provider credentials

```text theme={null}
droyd auth providers list [--json]
droyd auth providers openrouter set --from-env <name> [--label <label>] [--json]
droyd auth providers openrouter revoke [--json]
```

`set` reads the OpenRouter API key from the named environment variable.
`providers list` returns credential metadata, not secret values. `revoke`
removes the active user-default OpenRouter credential.

See [Authentication and configuration](/cli/authentication) for safe examples.
