https://github.com/MoonshotAI/kimi-cli
Kimi CLI is your next CLI agent.
https://github.com/MoonshotAI/kimi-cli
Last synced: 4 months ago
JSON representation
Kimi CLI is your next CLI agent.
- Host: GitHub
- URL: https://github.com/MoonshotAI/kimi-cli
- Owner: MoonshotAI
- License: apache-2.0
- Created: 2025-10-15T12:58:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-10-31T08:19:22.000Z (4 months ago)
- Last Synced: 2025-10-31T08:23:28.232Z (4 months ago)
- Language: Python
- Size: 1.39 MB
- Stars: 2,099
- Watchers: 16
- Forks: 149
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- AiTreasureBox - MoonshotAI/kimi-cli - 02-01_5559_43](https://img.shields.io/github/stars/MoonshotAI/kimi-cli.svg)|Kimi Code CLI is your next CLI agent.| (Repos)
- awesome-LLM-resources - Kimi-CLI
- awesome-vibe-coding - Kimi CLI - context workflows | CLI coding assistant with strong context handling and agent flows. | (CLI & Terminal Tools / AI Coding CLIs)
- awesome-vibe-coding - kimi-cli - Kimi官方命令行界面，一个帮助编程任务和开发工作流的AI助手。 (命令行工具)
- Awesome-Vibe-Coding - Kimi CLI
- awesome-starred - MoonshotAI/kimi-cli - Kimi Code CLI is your next CLI agent. (Python)
README
# Kimi CLI
[](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
[](https://github.com/MoonshotAI/kimi-cli/actions)
[](https://pypi.org/project/kimi-cli/)
[](https://pypistats.org/packages/kimi-cli)
[中文](https://www.kimi.com/coding/docs/kimi-cli.html)
Kimi CLI is a new CLI agent that can help you with your software development tasks and terminal operations.
> [!IMPORTANT]
> Kimi CLI is currently in technical preview.
## Key features
- Shell-like UI and raw shell command execution
- Zsh integration
- [Agent Client Protocol] support
- MCP support
- And more to come...
[Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
## Installation
> [!IMPORTANT]
> Kimi CLI currently only supports macOS and Linux. Windows support is coming soon.
Kimi CLI is published as a Python package on PyPI. We highly recommend installing it with [uv](https://docs.astral.sh/uv/). If you have not installed uv yet, please follow the instructions [here](https://docs.astral.sh/uv/getting-started/installation/) to install it first.
Once uv is installed, you can install Kimi CLI with:
```sh
uv tool install --python 3.13 kimi-cli
```
Run `kimi --help` to check if Kimi CLI is installed successfully.
> [!IMPORTANT]
> Due to the security checks on macOS, the first time you run `kimi` command may take 10 seconds or more depending on your system environment.
## Upgrading
Upgrade Kimi CLI to the latest version with:
```sh
uv tool upgrade kimi-cli --no-cache
```
## Usage
Run `kimi` command in the directory you want to work on, then send `/setup` to setup Kimi CLI:
After setup, Kimi CLI will be ready to use. You can send `/help` to get more information.
## Features
### Shell mode
Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-X`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
> [!NOTE]
> Built-in shell commands like `cd` are not supported yet.
### Zsh integration
You can use Kimi CLI together with Zsh, to empower your shell experience with AI agent capabilities.
Install the [zsh-kimi-cli](https://github.com/MoonshotAI/zsh-kimi-cli) plugin via:
```sh
git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli
```
> [!NOTE]
> If you are using a plugin manager other than Oh My Zsh, you may need to refer to the plugin's README for installation instructions.
Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
```sh
plugins=(... kimi-cli)
```
After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
### ACP support
Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
For example, to use Kimi CLI with [Zed](https://zed.dev/), add the following configuration to your `~/.config/zed/settings.json`:
```json
{
"agent_servers": {
"Kimi CLI": {
"command": "kimi",
"args": ["--acp"],
"env": {}
}
}
}
```
Then you can create Kimi CLI threads in Zed's agent panel.
### Using MCP tools
Kimi CLI supports the well-established MCP config convention. For example:
```json
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
},
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
```
Run `kimi` with `--mcp-config-file` option to connect to the specified MCP servers:
```sh
kimi --mcp-config-file /path/to/mcp.json
```
## Development
To develop Kimi CLI, run:
```sh
git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli
make prepare # prepare the development environment
```
Then you can start working on Kimi CLI.
Refer to the following commands after you make changes:
```sh
uv run kimi # run Kimi CLI
make format # format code
make check # run linting and type checking
make test # run tests
make help # show all make targets
```
## Contributing
We welcome contributions to Kimi CLI! Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.