If you have used tools like Claude Code or similar terminal-based AI agents, Kimi Code CLI will feel familiar. It is Moonshot AI's open-source coding agent that lives in your terminal, reads and edits your code, runs shell commands, and works through tasks step by step based on the results it gets back.
This post explains what Kimi Code CLI is, why it might be useful to you, and walks through installing and using it for the first time.
Kimi Code CLI is an AI coding agent that runs directly in your terminal. Instead of copying code back and forth between a chat window and your editor, you describe a task in plain language, and the agent:
It works out of the box with Moonshot AI's Kimi models, and it can also be pointed at other compatible providers like Anthropic, OpenAI, or Google by editing a config file.
The project is written in TypeScript, MIT licensed, and distributed as a single binary, so you do not need a Node.js setup just to run it.
A few design choices make it worth trying if you already use a terminal-based AI agent, or are looking for your first one:
/mcp-config
, instead of hand-editing JSON files.coder
, explore
, and plan
subagents can run in isolated contexts in parallel, keeping your main conversation clean.You have two main installation paths: the official install script, or npm.
macOS or Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Windows (PowerShell)
irm https://code.kimi.com/kimi-code/install.ps1 | iex
On Windows, install Git for Windows first, since Kimi Code CLI uses the bundled Git Bash as its shell environment. If Git Bash is in a non-standard location, set the KIMI_SHELL_PATH
environment variable to the full path of bash.exe
.
Homebrew (macOS/Linux)
brew install kimi-code
The script downloads the latest release, verifies its checksum, and adds the kimi
executable to your PATH.
If you already have Node.js 22.19.0 or later:
node --version
npm install -g @moonshot-ai/kimi-code
Or with pnpm:
pnpm add -g @moonshot-ai/kimi-code
Open a new shell session and run:
kimi --version
If that prints a version number, you are ready to go.
Move into a project directory and start the interactive UI:
cd your-project
kimi
On first launch, log in from inside the CLI:
/login
This opens a platform selector with two options:
platform.kimi.com
or platform.kimi.ai
.To log out later, run /logout
.
If you would rather use Anthropic, OpenAI, Google, or another compatible provider, edit ~/.kimi-code/config.toml
directly and add your API key there.
Once logged in, just describe what you want in plain English. A good first prompt is to have it explore your project:
Take a look at this project's directory structure and briefly describe what each directory is for.
Kimi Code CLI will call its file-reading and search tools automatically to gather context before answering. Read-only operations run without asking for confirmation. Anything that modifies files or runs shell commands will prompt you to approve it first.
You can also hand it a concrete coding task:
Add a function in src/utils that converts any string to kebab-case, and add a unit test for it.
The agent plans the steps, edits the code, runs the tests, and reports back what it did.
kimi -p "Take a look at this project's directory structure"
kimi -c
| Command | What it does |
|---|---|
/help |
|
| Opens the command and shortcut panel | |
/new |
|
| Starts a new session, clearing current context | |
/sessions |
|
| Browse and resume past sessions | |
/model |
|
| Switch the active model | |
/compact |
|
| Manually compress context to free up tokens | |
/fork |
|
| Fork the current session, keeping history but continuing separately | |
/mcp-config |
|
| Add and authenticate MCP servers conversationally | |
/exit |
|
| Exit the CLI |
Handy keyboard shortcuts:
| Shortcut | What it does |
|---|---|
Esc |
|
| Interrupt streaming output or close a popup | |
Ctrl-C |
|
| Interrupt output; press twice while idle to exit | |
Shift-Tab |
|
| Toggle Plan mode | |
Ctrl-S |
|
| Inject a message mid-stream | |
Ctrl-O |
|
| Collapse or expand tool output |
Kimi Code CLI supports the Agent Client Protocol, which lets editors like Zed and JetBrains drive a session directly.
For Zed, add this to ~/.config/zed/settings.json
:
{
"agent_servers": {
"Kimi Code CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}
Then open a new conversation in Zed's Agent panel. No extra login is needed since it reuses your existing CLI credentials.
Kimi Code CLI stores config files, session records, logs, and its update cache under ~/.kimi-code/
by default. If you want to move that elsewhere, set the KIMI_CODE_HOME
environment variable to a different path.
Upgrade
kimi upgrade
Or, if you installed via npm:
npm install -g @moonshot-ai/kimi-code@latest
Uninstall
If you installed via the script, just delete the kimi
executable. If you installed via npm:
npm uninstall -g @moonshot-ai/kimi-code
If you want to contribute or run the latest code from main
:
git clone https://github.com/MoonshotAI/kimi-code.git
cd kimi-code
pnpm install
pnpm dev:cli # run the CLI in dev mode
pnpm test # run tests
pnpm typecheck # TypeScript check
pnpm lint # oxlint
pnpm build # build all packages
This requires Node.js 24.15.0 or later and pnpm 10.33.0. Check CONTRIBUTING.md
in the repo for the full contribution guide.
Kimi Code CLI brings together a lot of what people already like about terminal-based AI coding agents: a fast single-binary install, a clean TUI, subagents, MCP support, and editor integration through ACP. The video input feature and the conversational MCP setup are the two pieces that stand out as genuinely different from similar tools.
If you want to try it, the fastest path is the install script followed by /login
. From there, just start describing what you want done.
Links