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

# status

> Show translation coverage for all locales

The `status` command displays an overview of your project's translation progress, including per-locale status and coverage percentages.

## Usage

```bash theme={null}
npx lazylocales status [options]
```

## Options

| Flag     | Description                  |
| -------- | ---------------------------- |
| `--json` | Output machine-readable JSON |

## What it shows

<Steps>
  <Step title="Project info">
    Displays your project name, ID, source locale, and key count.

    ```
    Project: my-app (proj_abc123)
    Source:  en — 142 keys (v4)
    ```
  </Step>

  <Step title="Pending changes">
    If the source file has been updated but translations haven't run yet, shows the pending diff:

    ```
    ⚠ Pending changes: +3 added, ~1 modified, -0 deleted
    ```
  </Step>

  <Step title="Locale coverage table">
    Shows the translation status for each target locale:

    ```
    ┌─────────┬──────────────┬──────────────┬───────────┬──────────┐
    │ Locale  │ Language     │ Status       │ Keys      │ Coverage │
    ├─────────┼──────────────┼──────────────┼───────────┼──────────┤
    │ nl-NL   │ Dutch        │ synced       │ 142/142   │ 100%     │
    │ fr-FR   │ French       │ synced       │ 142/142   │ 100%     │
    │ de      │ German       │ behind       │ 139/142   │ 98%      │
    └─────────┴──────────────┴──────────────┴───────────┴──────────┘
    ```
  </Step>
</Steps>

## Locale statuses

| Status    | Description                                      |
| --------- | ------------------------------------------------ |
| `pending` | Locale added but never translated                |
| `synced`  | All keys translated and up to date               |
| `behind`  | Source file changed since last translation       |
| `error`   | Translation job failed                           |
| `removed` | Locale marked for removal (file will be renamed) |

## Examples

View translation status:

```bash theme={null}
npx lazylocales status
```

Get status as JSON:

```bash theme={null}
npx lazylocales status --json
```