Find and fill missing vue-i18n translations
vue-i18n warns about a missing key in the console and shows the fallback locale, so a gap in de.json ships quietly. Below, one command finds it and another fills it.
The example project
A small vue-i18n project: the English source and a German file that fell behind. The commands below ran on exactly these files.
{
"nav": {
"greeting": "Hi, {name}!",
"signOut": "Sign out"
},
"cart": {
"items": "no items | {count} item | {count} items",
"checkout": "Go to checkout",
"help": "Questions? Write to {'@'}support"
}
}
{
"nav": {
"greeting": "Hallo, {Name}!",
"signOut": "Abmelden"
},
"cart": {
"items": "keine Artikel | {count} 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 src/locales/en.json --langs de
✗ de: 1 missing key(s): cart.help
✗ de: 1 placeholder mismatch(es):
nav.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
nav.greeting: lost placeholder {name}
nav.greeting: invented placeholder {Name} (not in source)
cart.items: placeholder {count} appears 2× in source but 1× in translation
✗ 1 missing key, 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 src/locales/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: 1 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 1 strings · 2.3s
32 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 1 key(s) → src/locales/de.json
→ 4 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.
{
"nav": {
"greeting": "Hallo, {Name}!",
"signOut": "Abmelden"
},
"cart": {
"items": "keine Artikel | {count} Artikel",
"checkout": "Zur Kasse",
"help": "Fragen? Schreiben Sie an {'@'}support"
}
}
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 src/locales/en.json --langs de
✗ de: 1 placeholder mismatch(es):
nav.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
nav.greeting: lost placeholder {name}
nav.greeting: invented placeholder {Name} (not in source)
cart.items: placeholder {count} appears 2× in source but 1× in translation
✗ 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 vue-i18n
Missing keys
Reported by full path, such as
cart.help.Renamed interpolations
{Name}in place of{name}is reported as one lost and one invented.Literal interpolations
{'@'}dropped from a translation is reported.Not checked yet
The number of pipe forms. Above, the dropped form was caught only because it held
{count}.
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
Are pipe plurals checked?
Not in 0.2.42: the forms between pipes are not counted. Count them by hand in the languages you ship until a release does.
Are literals like {'@'} kept?
Yes. The translation above kept {'@'}, and a translation that drops it fails the check.
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 · next-intl · Flutter · iOS · Android