---
title: argusctl cost
description: GPU spend: month-to-date, current hourly burn, run-rate forecast.
---

# argusctl cost



{/* 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 cost`

GPU spend: month-to-date, current hourly burn, run-rate forecast.

```bash
argusctl cost <subcommand>
```

### `argusctl cost month`

Month-to-date GPU spend + current burn + provider/tenant breakdown.

```bash
argusctl cost month [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

### `argusctl cost now`

Current instantaneous hourly burn (allocated + unallocated) by provider/tenant.

```bash
argusctl cost now [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

### `argusctl cost forecast`

Straight-line run-rate projection (hourly → daily → 30-day) from the current burn.

```bash
argusctl cost forecast [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

### `argusctl cost idle`

Money burned on idle running pods (0 cameras): the "stop these" list + daily/monthly waste.

```bash
argusctl cost idle [options]
```

| Option              | Description                                              |
| ------------------- | -------------------------------------------------------- |
| `--watch [seconds]` | live refresh every N seconds (default 5); Ctrl+C to stop |
| `--api <url>`       | API base URL                                             |
| `--token <pat>`     | PAT to use                                               |
| `--json`            | JSON output                                              |
| `--fields <list>`   | comma-separated fields to include                        |

## Examples

```bash
argusctl cost month
argusctl cost now
argusctl cost forecast
```


---

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)