---
name: cli-auth
description: Sign-in and bootstrap for the paperos CLI. Use when you need to initialize, authenticate, or troubleshoot token/login setup.
---

# CLI Auth

Use this for onboarding and auth diagnostics with the `paperos` CLI.

## Initialize

```sh
paperos init
```

Prompts:
- Email
- Host
- Issuer
- Optional token and bunch

## Login

```sh
paperos auth login
```

Optional flags:

```sh
paperos auth login --issuer <issuer-url> --label my-laptop --ttl 86400
```

## Verify identity

```sh
paperos whoami
paperos account
paperos doctor
```

## Common fixes

- Missing token:
  run `paperos auth login` again.
- Wrong host:
  set `BNNA_HOST` in `.env` and rerun login.
- Wrong issuer:
  set `BNNA_ISSUER` or pass `--issuer`.