Find and fill missing next-intl messages
When messages/de.json lacks a key, next-intl logs an error and renders a fallback; a plural without other does not format at all. Below, one command finds both, and another fills the gaps.
The example project
A small next-intl project: the English source and a German file that fell behind. The commands below ran on exactly these files.
{
"Header": {
"greeting": "Hi, {name}!",
"signOut": "Sign out"
},
"Cart": {
"items": "{count, plural, =0 {Your cart is empty} one {# item} other {# items}}",
"checkout": "Go to checkout",
"total": "Total: {total, number, ::currency/EUR}"
}
}
{
"Header": {
"greeting": "Hallo, {Name}!"
},
"Cart": {
"items": "{count, plural, =0 {Dein Warenkorb ist leer} one {# Artikel}}",
"checkout": "Zur Kasse"
}
}
1. Find what is missing
kaeris check compares each translation with the source file. It runs offline with no key or account, and exits with code 1 when it finds a problem, so a CI job can stop on it.
$ npx kaeris check --source messages/en.json --langs de
✗ de: 2 missing key(s): Cart.total, Header.signOut
✗ de: 1 placeholder mismatch(es):
Header.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
Header.greeting: lost placeholder {name}
Header.greeting: invented placeholder {Name} (not in source)
Cart.items: ICU plural is missing the required 'other' branch
✗ 2 missing keys, 1 placeholder mismatch, 3 translation faults
2. Translate only the missing keys
--only-new sends only the keys the German file lacks and merges them in. Lines already in the file stay as they are, broken ones included. The command is in the Python package: pip install kaeris.
$ kaeris translate messages/en.json --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ de: 2 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 2 strings · 3.6s
46 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 2 key(s) → messages/de.json
→ 3 key(s) already exist in de but nothing in kaeris.lock vouches for them, so they were left alone AND left unlocked. If the source changed after those files were made, those edits are NOT translated. Re-run once with --no-only-new to rebuild them, or with --assume-current if the files are known to match.
{
"Header": {
"greeting": "Hallo, {Name}!",
"signOut": "Abmelden"
},
"Cart": {
"items": "{count, plural, =0 {Dein Warenkorb ist leer} one {# Artikel}}",
"checkout": "Zur Kasse",
"total": "Gesamt: {total, number, ::currency/EUR}"
}
}
3. Check again
The missing keys are filled. What is left was broken before this run: fix those lines by hand, or translate the whole file again with --no-only-new.
$ npx kaeris check --source messages/en.json --langs de
✗ de: 1 placeholder mismatch(es):
Header.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
Header.greeting: lost placeholder {name}
Header.greeting: invented placeholder {Name} (not in source)
Cart.items: ICU plural is missing the required 'other' branch
✗ 1 placeholder mismatch, 3 translation faults
Run on 2 November 2026 on the free tier, without a key: npx kaeris 0.2.42 for the check, kaeris 0.2.42 from PyPI for the translation. Output as printed, except that progress lines and the local folder path are left out.
What kaeris check catches in next-intl
Missing messages in any namespace
Reported by full path:
Cart.total,Header.signOut.Renamed arguments
{Name}in place of{name}is reported as one lost and one invented argument.ICU branches
A
pluralorselectwithout the requiredotherbranch is an error.Formatted arguments
{total, number, ::currency/EUR}cut down to{total}is reported, worded as an invented placeholder.
What it costs
kaeris checkis freeIt runs on your machine: no key, no account, no limit.
Translation is free to start
Without a key: 10,000 characters per file, 300,000 a day, up to 8 languages per run. A free key raises this to 50,000 characters per file and 1.5M a month. Volume counts characters once per target language.
Beyond the free tier
Lifetime is $79 once and runs on your own OpenRouter key, so the model is paid separately. Pro is $19 a month or $190 a year for 12M characters a month. Pricing
Questions
Why does a plural without other matter?
ICU requires the other branch. The message does not parse without it, so next-intl shows its fallback instead of the text.
Does it read nested namespaces?
Yes. Keys are reported by full path, and new ones are merged into the right object.
Can it run in CI?
Yes. npx kaeris check exits with code 1 when it finds a problem. Recipes: GitHub Actions, GitLab CI, pre-commit.
Keep going
Check reference · CLI reference · Free check in the browser · Translate in the browser
Other stacks: react-i18next · vue-i18n · Flutter · iOS · Android