# tanomis agent versions

Reference for tanomis agent versions: list an agent's version lineage (label, id, status, kind).

Generated from the <code>tanomis</code> command tree on 2026-10-01. Flags and defaults match the binary; run <code>tanomis agent versions --help</code> for the version you have installed.

## Usage

```text title="Usage"
tanomis agent versions NAME [flags]
```

## Description

List an agent's immutable version lineage.

With `--by-tenant`, render the version-centric rollout view instead: for each version,
the tenants that serve it as baseline and as canary. This is the reverse of
`tanomis agent get` (agent→tenants) and `tanomis agent ls `--tenant`` (tenant→agents), and answers
"who is on v2?" directly.

## Flags

| Flag | Type | Description |
|---|---|---|
| `--by-tenant` | bool | Show, per version, which tenants serve it as baseline/canary. |

<details>
<summary>Global flags</summary>

| Flag | Type | Description |
|---|---|---|
| `--config` | string | Config file path. |
| `--context` | string | Config context to use. |
| `-o`, `--output` | string | Output format: table\|json. |
| `--tenant` | string | Tenant id (X-Tenant-ID). |
| `--verbose` | bool | Verbose output. |

</details>