MoonshotAI / MoonshotAI/kimi-cli
[Feature Request] Add multi-language (i18n) support for CLI output, starting with Simplified Chi nese (zh-CN)
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 11.4k
- Forks
- 1.3k
- Avg merge
- 9h 47m
- Merged PRs (30d)
- 2
Description
Feature Description
Currently, all CLI output, prompts, help documentation, and error messages in kimi-cli are in
English. While this is standard for many development tools, it creates a significant learning cu
rve and usability barrier for non-English speaking users, particularly the large community of Ch
inese-speaking developers.
Proposed Solution
I would like to propose adding internationalization (i18n) support to kimi-cli, with Sim
plified Chinese (zh-CN) as the first priority target language.
Implementation Suggestions:
-
Language Switching: Support runtime language switching via:
- Environment variable:
KIMI_CLI_LANG=zh_CN - Command-line flag:
--lang zh_CNor-l zh_CN - Or automatically detect system locale (
LANG/LC_ALLenvironment variables)
- Environment variable:
-
Scope of Localization: All user-facing strings should be translatable, including:
- Command help text (
kimi --help, subcommand help) - Interactive prompts and confirmations
- Success / error / warning messages
- Status indicators and progress messages
- Menu titles and option labels
- Command help text (
-
Translation Storage: Consider standard i18n frameworks or simple JSON/TOML translation fi
les stored under alocales/ori18n/directory, allowing community contributions for additio
nal languages over time.
Motivation / Use Case
As a CLI agent tool aiming to improve developer productivity, accessibility in the user's native
language greatly lowers the barrier to entry. Many successful CLI tools (e.g., npm, docker,
git in some distributions) provide localized output, which is especially helpful for:
- Beginners who are not fluent in English
- Teams who need to onboard members quickly
- Reducing cognitive load when reading error messages under time pressure
Example
Current behavior:
$ kimi --help
Usage: kimi [OPTIONS] [PROMPT]...
Kimi Code CLI is your next CLI agent.
Options:
--model, -m TEXT Model to use
--help Show this message and exit.
Desired behavior (when KIMI_CLI_LANG=zh_CN or system locale is zh-CN):
$ kimi --help
用法: kimi [选项] [提示词]...
Kimi Code CLI 是您的下一代命令行智能助手。
选项:
--model, -m 文本 指定要使用的模型
--help 显示此帮助信息并退出
Willingness to Contribute
─────────────────────────
I and other community members would be happy to help provide and maintain the Simplified Chinese
translation files if the maintainers agree on the i18n architecture and direction.
Additional Context
──────────────────
• Related keywords: i18n, l10n, internationalization, localization, 中文, Chinese, multilingual
• This request is about CLI output localization, not model language capabilities (the model alre
y speaks Chinese perfectly).
Thank you for considering this feature request!
---
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the kimi --help entry point and inventory how help text, prompts, errors, status messages, and option labels are produced. Resolve the language-selection mechanism and translation storage approach before implementing Simplified Chinese output; done means the stated user-facing CLI surfaces respond to KIMI_CLI_LANG=zh_CN, a language flag, or locale detection as agreed.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- cli, internationalization
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100