# tanomis agent promote

Reference for tanomis agent promote: promote a version to production (alias for transition --to production).

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

## Usage

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

## Description

Promote a version to production (alias for transition `--to` production).

## Flags

| Flag | Type | Description |
|---|---|---|
| `--by` | string | Identity recorded as the principal. Default `local-dev`. |
| `--scope-tenant` | string | Select the tenant-scoped agent of this name (default: the global agent). |
| `--version` | string | Version label to promote. |

<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>