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

# Auth

> Manage authentication. Credentials live in ~/.config/eigenpal/credentials.json as named profiles. Switch tenants with auth use <name> or set EIGENPAL_PROFILE=<name> for one shell.

## Commands

### Core

| Command                                    | Description                                                                                                                                                                                                                          |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `eigenpal auth login [options]`            | Authenticate with EigenPal. Opens a browser to create an API key, stores it under a profile named after the tenant, and makes that profile active. Re-running `login` against the same tenant updates the existing profile in place. |
| `eigenpal auth logout [options] [profile]` | Remove a profile from the credentials file. Defaults to the active profile if no name is given. After removal the next available profile becomes active.                                                                             |
| `eigenpal auth list\|ls [options]`         | List configured profiles. The active one is marked ●, switch with `auth use`.                                                                                                                                                        |
| `eigenpal auth use [options] [profile]`    | Switch the active profile (persistent across shells). Omit `[profile]` to pick from a list. For one-shot per-shell switching, set `EIGENPAL_PROFILE=<name>` instead.                                                                 |

## Details

### `eigenpal auth login [options]`

Authenticate with EigenPal. Opens a browser to create an API key, stores it under a profile named after the tenant, and makes that profile active. Re-running `login` against the same tenant updates the existing profile in place.

### Options

| Flag               | Required | Default | Description     |
| ------------------ | -------- | ------- | --------------- |
| `--base-url <url>` | no       |         | Server base URL |

### `eigenpal auth logout [options] [profile]`

Remove a profile from the credentials file. Defaults to the active profile if no name is given. After removal the next available profile becomes active.

### Arguments

| Name      | Required | Variadic | Description |
| --------- | -------- | -------- | ----------- |
| `profile` | no       | no       |             |

### `eigenpal auth list|ls [options]`

List configured profiles. The active one is marked ●, switch with `auth use`.

### `eigenpal auth use [options] [profile]`

Switch the active profile (persistent across shells). Omit `[profile]` to pick from a list. For one-shot per-shell switching, set `EIGENPAL_PROFILE=<name>` instead.

### Arguments

| Name      | Required | Variadic | Description |
| --------- | -------- | -------- | ----------- |
| `profile` | no       | no       |             |