# tanomis agent

Reference for tanomis agent: author, register, and inspect agents.

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

## Usage

```text title="Usage"
tanomis agent
```

## Description

Author, register, and inspect agents.

## Commands

| Command | Description |
|---|---|
| [`tanomis agent delete-local`](/cli/agent/delete-local) | delete a scaffolded agent directory from disk |
| [`tanomis agent deploy`](/cli/agent/deploy) | package, upload, and remotely build an agent from local source |
| [`tanomis agent disable`](/cli/agent/disable) | remove an agent's enablement for specific tenants (inverse of enable) |
| [`tanomis agent enable`](/cli/agent/enable) | enable a global agent for tenants |
| [`tanomis agent get`](/cli/agent/get) | show the agent and versions served in the selected workspace |
| [`tanomis agent harnesses`](/cli/agent/harnesses) | list available agent harnesses |
| [`tanomis agent inventory`](/cli/agent/inventory) | list the per-version inventory (AI-BOM) of the agents a tenant can see |
| [`tanomis agent ls`](/cli/agent/ls) | list registered agents (or, with `--tenant`, the agents a tenant can run) |
| [`tanomis agent new`](/cli/agent/new) | scaffold a new agent from a harness template |
| [`tanomis agent promote`](/cli/agent/promote) | promote a version to production (alias for transition `--to` production) |
| [`tanomis agent rm`](/cli/agent/rm) | soft-retire one scope-qualified agent from the registry |
| [`tanomis agent rollout`](/cli/agent/rollout) | roll a version out to specific tenants (promote-if-needed, then enable) |
| [`tanomis agent statuses`](/cli/agent/statuses) | show the version lifecycle: statuses and their allowed transitions |
| [`tanomis agent versions`](/cli/agent/versions) | list an agent's version lineage (label, id, status, kind) |

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