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

# sumvin sigil

> Check the state of your Sigil from the terminal.

<Warning>
  **The CLI is for developers.** It's mainly for people building and experimenting on Sumvin. The recommended way to use Sumvin is the [MCP connector](/get-started/connect), or the API if you're building (docs coming).

  An agent running in your terminal can approve Stamped Mandates that the CLI signs for you. Never give an unattended agent `--yes`.
</Warning>

Shows the state of your Sigil — your verified agent identity. This is a read-only group: a Sigil is issued automatically once verification finishes, so there's nothing to trigger here, only to check.

```bash theme={null}
sumvin sigil show
```

Needs a signed-in session — see [`sumvin login`](/reference/cli/auth).

**Flags**

| Flag     | Effect                                               |
| -------- | ---------------------------------------------------- |
| `--json` | Print a result object instead of the formatted view. |

## The six states

| State          | Meaning                                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| `not_verified` | You haven't completed identity verification yet.                                                                   |
| `not_started`  | You're verified, but nothing has started yet. This is a normal, common answer — it doesn't mean anything is wrong. |
| `in_flight`    | Your Sigil is being issued. Check back shortly.                                                                    |
| `failed`       | Issuing didn't complete after repeated attempts. This needs support's attention, not another retry.                |
| `minted`       | Your Sigil exists.                                                                                                 |
| `unknown`      | This CLI build doesn't recognise the state your account returned. Update the CLI, or check the Sumvin app.         |

**Example**

```bash theme={null}
sumvin sigil show --json
```

```json theme={null}
{
  "ok": true,
  "exit_code": 0,
  "command": "sigil show",
  "data": {
    "state": "minted",
    "kyc_status": "approved"
  }
}
```

`data.state` is the field to branch on — read it rather than the prose.

## Exit codes

`0` for any of the six states above, including `failed` — reading your Sigil's state is a successful read even when the state itself isn't good news. `1` if you're not signed in or the read itself couldn't complete.

<Info>
  See [Sigil](/concepts/sigil) for what a Sigil is and why it matters, and [`sumvin kyc`](/reference/cli/kyc) for the verification a Sigil depends on.
</Info>