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

# facet whoami

> Print the signed-in identity

## Usage

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet whoami
```

Prints the identity associated with the current credential by calling `GET /v0/auth/me`.

## Exit codes

| Code | Meaning                                                     |
| ---- | ----------------------------------------------------------- |
| `0`  | Identity displayed successfully.                            |
| `1`  | Failed (no credential found, invalid token, network error). |

## What it does

<Steps>
  <Step title="Resolve credential">
    Checks `FACET_TOKEN` environment variable first, then the credentials file at `$FACET_DIR/credentials` (default `~/.facet/credentials`).
  </Step>

  <Step title="Query registry">
    Calls `GET /v0/auth/me` with the resolved token.
  </Step>

  <Step title="Display identity">
    Shows the username, email, account tier, and credential source.
  </Step>
</Steps>

## Output

```
yourname <you@example.com>
  tier: free
  registry: https://api.agentfacets.io
```

If the credential was resolved from `FACET_TOKEN` instead of the saved file:

```
yourname <you@example.com>
  tier: free
  registry: https://api.agentfacets.io
  credential: FACET_TOKEN (environment)
```

The `registry` line is always printed and shows the base URL the identity was resolved against.

If the account is suspended, the suspended status is shown.

## See also

* [`facet login`](/cli/login) -- sign in to the registry.
* [`facet logout`](/cli/logout) -- remove saved credentials.