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

# ezforge auth

> Authenticate with ezForge Platform

## ezforge auth login

Authenticate the CLI with your ezForge account. Opens a browser window to complete the OAuth flow.

```bash theme={null}
ezforge auth login
```

On success, credentials are stored in `~/.config/ezforge/config.json`.

**Flags:**

| Flag              | Description                                           |
| ----------------- | ----------------------------------------------------- |
| `--api-key <key>` | Authenticate with an API key instead of browser OAuth |

**Example (API key):**

```bash theme={null}
ezforge auth login --api-key ezf_live_xxxxxxxxxxxxxxxxxxxx
```

***

## ezforge auth logout

Revoke the current session and remove stored credentials.

```bash theme={null}
ezforge auth logout
```

***

## ezforge auth status

Show the currently authenticated account.

```bash theme={null}
ezforge auth status
```

Output:

```
Logged in as you@example.com
Project: my-first-project (proj_abc123)
```