CLI Commands
status
Translation coverage in one call: per-locale and per-layer counts of total, translated, missing and empty keys, plus an overall completion percentage.
Synopsis
the-i18n-cli status
Flags
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--layer | string | no | — | Layer name to scope this to (e.g., "root", "app-admin"). If omitted, every layer is included. Call discover to list the layers. |
--referenceLocale, --ref | string | no | — | Locale code used as the source of truth (e.g., "en", "en-US"). Defaults to the project default locale. |
--listEmpty | boolean | no | false | Also list the keys behind summary.emptyKeys under "empty" (locale → layer → keys), and keys that are empty in the reference locale itself under "emptyInReference" — useful after a scaffold or an interrupted translation run. Default: false, which returns counts only. |
--outputFile | string | no | — | Absolute path to write the full JSON output to. Only a compact summary is returned to the caller, which is what you want for a result too large to read in one piece. Example: ".i18n-reports/translation-status.json" |
--codequalityOutput | string | no | — | Also write the incomplete locales and unconsumed layers as a GitLab Code Quality (CodeClimate) JSON report to this file path. |
--failUnder | string | no | — | Exit 2 when overall completion is below this percentage (CI gate). |