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

# tai auth

> Identity and capability introspection.

Identity and capability introspection.

```console theme={null}
$ tai auth [OPTIONS] COMMAND [ARGS]...
```

## `tai auth claim`

Exchange a one-time claim link for its API key — runs WITHOUT a credential.

Pass the bare token or the whole claim URL; the token is taken from the `#claim=`
fragment. The exchanged API key is printed ONCE — capture it now (there is no second
exchange; the link is single-use). A used/unknown/expired token answers the same
`unknown or already used claim token`.

Example: `tai auth claim 'https://host/login#claim=<token>'`

```console theme={null}
$ tai auth claim [OPTIONS] TOKEN
```

| Argument | Description                                                             |
| -------- | ----------------------------------------------------------------------- |
| `TOKEN`  | A claim token or a full claim URL/fragment (either works). *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai auth whoami`

Print the caller's derived capability projection.

Example: `tai auth whoami`

```console theme={null}
$ tai auth whoami [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |