polyglot-i18n/Polyglot i18n Scanner
Detect untranslated strings in your codebase and post a coverage report on PRs
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| api-key | Polyglot API key (POLYGLOT_API_KEY). If empty, the CLI runs in guest mode. | no | "" |
| coverage-threshold | Minimum translation coverage percentage required to pass (0-100). The check fails if average coverage is below this value. | no | 100 |
| config_path | Path to polyglot.toml (default: auto-detect) | no | "" |
| check-mode | Check behavior: legacy preserves the v1 full-tree scan/coverage gates; differential compares explicit event revisions with `polyglot check`. | no | legacy |
| api-url | Polyglot API origin used for authenticated CI run reporting | no | https://api.getpolyglot.ai |
| managed-token | Short-lived managed run token returned by the Polyglot GitHub OIDC exchange | no | "" |
| managed-run-id | Polyglot managed CI run UUID bound to managed-token | no | "" |
| managed-policy-hash | Immutable managed policy hash bound to the run | no | "" |
| managed-finding-hash-key | Run-bound HMAC key returned by the managed OIDC exchange | no | "" |
| fail_on_untranslated | Fail the check if untranslated strings are found | no | true |
| comment | Post a PR comment with the scan results | no | true |
| github_token | GitHub token for posting PR comments | no | ${{ github.token }} |
| version | Polyglot CLI version to install (default: latest) | no | latest |
| sync | After scanning, run `polyglot push` to sync this repo's existing translations into your project's backend memory (so the dashboard stops re-translating work you already have). Requires `api-key`. Runs ONLY on a push to the repository's default branch — never on pull_request — so un-merged PR translations are never written to shared memory. | no | false |
Outputs
| name | description |
|---|---|
| total_strings | Total number of untranslated strings found |
| files_scanned | Number of files scanned |
| files_with_strings | Number of files with untranslated strings |
| has_untranslated | Whether untranslated strings were found (true/false) |
| average_coverage | Average translation coverage percentage across configured languages |