
Plugs translation management directly into Claude and other AI coding tools via MCP. Exposes operations like find_orphan_keys, translate_missing, add_translations, and rename across all locale files at once. Particularly useful when your agent is building features that span multiple locales: it can write new keys, detect what's untranslated, and kick off translation sampling with your project's glossary and tone rules already loaded as context. Auto-detects Nuxt, Laravel, or generic JSON/PHP setups. Pairs with a CLI for terminal use. Handles layered translation architectures and includes a reportOutput mode that writes large responses to disk instead of flooding context windows.
The i18n toolkit for AI agents and large monorepos. Find missing keys, remove dead ones, and rename across every locale and layer at once — from your agent, your terminal, or your pipeline.
| Package | Version | What it is |
|---|---|---|
| @the-i18n-kit/cli | The CLI, and the library every other surface is built on | |
| @the-i18n-kit/mcp | MCP server, for AI coding agents | |
| @the-i18n-kit/nuxt | Publishes the layer graph Nuxt already resolved |
A GitHub Action and a GitLab CI template ship from this repository too.
npm install -g @the-i18n-kit/cli
the-i18n-cli init # write a config from what it detects
the-i18n-cli status # coverage per locale and per layer
the-i18n-cli missing # what is not translated yet
For an AI agent, point your MCP host at the server:
{
"mcpServers": {
"the-i18n-mcp": {
"command": "npx",
"args": ["@the-i18n-kit/mcp@latest"]
}
}
}
→ Getting started · MCP setup · CLI reference
Everything lives on the documentation site. The reference sections are generated from the source they describe, so they cannot drift from it.
| Why this toolkit | Who it is for, and who it is not |
| Monorepos and layers | The consumer graph, shared libraries, misplaced usages |
| Frameworks | Nuxt, Laravel, Vue, React/Next, generic |
| Configuration | Where it lives, precedence, every field |
| CI/CD | The Action and the GitLab template |
| CLI · MCP tools | Generated reference |
pnpm install
pnpm build
pnpm test
pnpm lint
pnpm typecheck
DEBUG=1 enables verbose logging to stderr. See CONTRIBUTING.md.