# tanomis agent rm

Reference for tanomis agent rm: soft-retire one scope-qualified agent from the registry.

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

## Usage

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

## Description

Soft-retire exactly one agent registration while preserving its audit history.
The scope selector is mandatory because global and tenant-scoped agents may share a name.
Use `--scope` global, or `--scope` tenant with `--scope-tenant-id` TENANT.

Aliases: `remove`.

## Flags

| Flag | Type | Description |
|---|---|---|
| `--scope` | string | Registration scope to retire: global or tenant (required). |
| `--scope-tenant-id` | string | Owning tenant id (required with `--scope` tenant). |
| `--yes` | bool | Skip the confirmation prompt. |

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