---
title: argusctl metadata
description: Read platform metadata (architecture + catalog + planner).
---

# argusctl metadata



{/* AUTO-GENERATED by scripts/generate-cli-reference.mjs from `argusctl introspect --json`.
    Do not edit by hand. Regenerate with: pnpm generate:cli */}

> Generated from argusctl v0.1.0 on 2026-06-09. Run `argusctl introspect --json` for the machine-readable tree.

## `argusctl metadata`

Read platform metadata (architecture + catalog + planner).

```bash
argusctl metadata <subcommand>
```

### `argusctl metadata workers`

Compute workers (running / idle / drained).

```bash
argusctl metadata workers <subcommand>
```

#### `argusctl metadata workers list`

List workers across providers.

```bash
argusctl metadata workers list [options]
```

| Option              | Description                                    |
| ------------------- | ---------------------------------------------- |
| `--provider <name>` | filter (aws \| runpod \| hetzner \| ...)       |
| `--status <s>`      | filter (running \| idle \| drained \| stopped) |
| `--api <url>`       |                                                |
| `--token <pat>`     |                                                |
| `--json`            |                                                |
| `--fields <list>`   |                                                |

### `argusctl metadata cameras`

Camera assignments.

```bash
argusctl metadata cameras <subcommand>
```

#### `argusctl metadata cameras list`

List cameras.

```bash
argusctl metadata cameras list [options]
```

| Option            | Description          |
| ----------------- | -------------------- |
| `--tenant <id>`   | filter by tenant\_id |
| `--api <url>`     |                      |
| `--token <pat>`   |                      |
| `--json`          |                      |
| `--fields <list>` |                      |

### `argusctl metadata catalog`

Compute catalog (price + freshness).

```bash
argusctl metadata catalog <subcommand>
```

#### `argusctl metadata catalog freshness`

Per-provider freshness: when did each catalog last refresh?

```bash
argusctl metadata catalog freshness [options]
```

| Option            | Description |
| ----------------- | ----------- |
| `--api <url>`     |             |
| `--token <pat>`   |             |
| `--json`          |             |
| `--fields <list>` |             |

#### `argusctl metadata catalog skus`

SKU pricing across providers.

```bash
argusctl metadata catalog skus [options]
```

| Option              | Description |
| ------------------- | ----------- |
| `--provider <name>` |             |
| `--api <url>`       |             |
| `--token <pat>`     |             |
| `--json`            |             |
| `--fields <list>`   |             |

### `argusctl metadata planner`

Capacity-planner decision log.

```bash
argusctl metadata planner <subcommand>
```

#### `argusctl metadata planner decisions`

Recent planner launch decisions with grades.

```bash
argusctl metadata planner decisions [options]
```

| Option               | Description                      |
| -------------------- | -------------------------------- |
| `--since <duration>` | 5m \| 1h \| 1d (default: server) |
| `-l, --limit <n>`    | max rows                         |
| `--api <url>`        |                                  |
| `--token <pat>`      |                                  |
| `--json`             |                                  |
| `--fields <list>`    |                                  |

#### `argusctl metadata planner summary`

Rolling A-F grade summary.

```bash
argusctl metadata planner summary [options]
```

| Option            | Description |
| ----------------- | ----------- |
| `--api <url>`     |             |
| `--token <pat>`   |             |
| `--json`          |             |
| `--fields <list>` |             |


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)