# logion usage

4 commands in this group.

- [`logion usage dismiss`](#logion-usage-dismiss)
- [`logion usage observe`](#logion-usage-observe)
- [`logion usage pending`](#logion-usage-pending)
- [`logion usage upload`](#logion-usage-upload)

## logion usage dismiss

```bash
logion usage dismiss [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] OBSERVATION_GROUP_ID
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `OBSERVATION_GROUP_ID` | string | — |  |

## logion usage observe

```bash
logion usage observe [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] --harness HARNESS [--stdin]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `--harness` | string | — | Harness name (e.g. codex, claude-code). |
| `--stdin` | flag | `True` | Read observation data from stdin. |

## logion usage pending

```bash
logion usage pending [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] [--since SINCE]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `--since` | string | `24h` | Only show observations newer than this window (e.g. 24h, 1h). |

## logion usage upload

```bash
logion usage upload [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] [--since SINCE] --task-class TASK_CLASS [--outcome OUTCOME] [--yes]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `--since` | string | `24h` | Only upload observations newer than this window (e.g. 24h). |
| `--task-class` | string | — | Coarse task class for the receipts (e.g. software-development). |
| `--outcome` | completed \| not_completed \| unknown | `unknown` |  |
| `--yes` | flag | — | Confirm upload in prompt mode after reviewing the payload. |

**Calls**

- [`submit_usage_receipt`](/docs/api/resource-feedback#submit-a-usage-receipt-for-a-resource-version)