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

# uniac auth

> Sign in and out.

## uniac auth login

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

Opens a browser to complete OAuth, captures the returned JWT on `http://127.0.0.1:8976/callback`, and writes it to `~/.uniac/auth.json` (mode 0600).

Flags:

| Flag            | Behavior                                                                  |
| --------------- | ------------------------------------------------------------------------- |
| `--host <host>` | Override the auth host (default `uniac.ai`).                              |
| `--no-browser`  | Print the URL instead of opening one; complete sign-in on another device. |
| `--manual`      | Paste a token directly instead of using the loopback callback.            |

The auth host can also be set via the `UNIAC_AUTH_HOST` env var.

## uniac auth status

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

Prints the signed-in user (sub, email) and the token's `expires_at`.

## uniac auth token

```bash theme={null}
uniac auth token
```

Prints the raw bearer token for use in scripts. Treat as a secret.

## uniac auth logout

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

Deletes `~/.uniac/auth.json`.