> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# status

> Report translation status per key/namespace/locale in CSV, with optional interactive TTY dashboard.

## Usage

```bash theme={null}
hyperlocalise status [--config <path>] [flags]
```

## Flags

* `--config`: path to config file
* `--locale`: target locale filter (repeatable)
* `--output`: output format (`csv`)
* `--group`: filter by group name
* `--bucket`: filter by bucket name
* `-i`, `--interactive`: render interactive dashboard in TTY (requires `--output csv`)

## Status values

* `translated`: value is non-empty and not marked as draft
* `needs_review`: provenance is `origin=llm` and `state=draft`
* `source_match`: markdown/mdx segment is non-empty but identical to the source text
* `untranslated`: value is empty

## CSV schema

`status --output csv` always emits this header:

```csv theme={null}
key,namespace,locale,status,origin,state
```

Column meaning:

* `key`: translation key identifier
* `namespace`: logical namespace for key grouping
* `locale`: target locale
* `status`: computed status classification
* `origin`: value source (`llm`, `human`, or adapter-originated provenance)
* `state`: workflow state (for example `draft` or curated-equivalent state)

## CI-ready label mapping (experimental)

Use this mapping when your pipeline expects product-level labels:

| CSV `status`   | CI-ready label |
| -------------- | -------------- |
| `translated`   | `ready`        |
| `needs_review` | `needs review` |
| `source_match` | `needs review` |
| `untranslated` | `missing`      |

## CI gate examples

Block when any entries are `missing`:

```bash theme={null}
hyperlocalise status --output csv > status.csv
awk -F, 'NR>1 && $4=="untranslated"{bad=1} END{exit bad}' status.csv
```

Block when `needs review` exceeds `20` rows:

```bash theme={null}
hyperlocalise status --output csv > status.csv
awk -F, 'NR>1 && $4=="needs_review"{count++} END{exit(count>20)}' status.csv
```

## Examples

```bash theme={null}
hyperlocalise status --locale es-ES --output csv
```

```bash theme={null}
hyperlocalise status --group default --output csv -i
```

## See also

* [run](/commands/run)
* [eval](/commands/eval)
* [sync pull](/commands/sync-pull)
* [sync push](/commands/sync-push)
* [Output formats](/reference/output-formats)