kimi-code 0.79__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,179 @@
1
+ Metadata-Version: 2.3
2
+ Name: kimi-code
3
+ Version: 0.79
4
+ Summary: Kimi Code is a CLI agent that lives in your terminal.
5
+ Requires-Dist: kimi-cli==0.79
6
+ Requires-Python: >=3.12
7
+ Description-Content-Type: text/markdown
8
+
9
+ # Kimi CLI
10
+
11
+ [![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
12
+ [![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
13
+ [![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
14
+ [![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
15
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/kimi-cli)
16
+
17
+ [Kimi Code](https://www.kimi.com/code/) | [Documentation](https://moonshotai.github.io/kimi-cli/en/) | [文档](https://moonshotai.github.io/kimi-cli/zh/)
18
+
19
+ Kimi CLI is an AI agent that runs in the terminal, helping you complete software development tasks and terminal operations. It can read and edit code, execute shell commands, search and fetch web pages, and autonomously plan and adjust actions during execution.
20
+
21
+ > [!IMPORTANT]
22
+ > Kimi CLI is currently in technical preview.
23
+
24
+ ## Getting Started
25
+
26
+ See [Getting Started](https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html) for how to install and start using Kimi CLI.
27
+
28
+ ## Key Features
29
+
30
+ ### Shell command mode
31
+
32
+ Kimi CLI is not only a coding agent, but also a shell. You can switch the shell command mode by pressing `Ctrl-X`. In this mode, you can directly run shell commands without leaving Kimi CLI.
33
+
34
+ ![](./docs/media/shell-mode.gif)
35
+
36
+ > [!NOTE]
37
+ > Built-in shell commands like `cd` are not supported yet.
38
+
39
+ ### IDE integration via ACP
40
+
41
+ Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
42
+
43
+ [Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
44
+
45
+ To use Kimi CLI with ACP clients, make sure to run Kimi CLI in the terminal and send `/setup` to complete the setup first. Then, you can configure your ACP client to start Kimi CLI as an ACP agent server with command `kimi acp`.
46
+
47
+ For example, to use Kimi CLI with [Zed](https://zed.dev/) or [JetBrains](https://blog.jetbrains.com/ai/2025/12/bring-your-own-ai-agent-to-jetbrains-ides/), add the following configuration to your `~/.config/zed/settings.json` or `~/.jetbrains/acp.json` file:
48
+
49
+ ```json
50
+ {
51
+ "agent_servers": {
52
+ "Kimi CLI": {
53
+ "command": "kimi",
54
+ "args": ["acp"],
55
+ "env": {}
56
+ }
57
+ }
58
+ }
59
+ ```
60
+
61
+ Then you can create Kimi CLI threads in IDE's agent panel.
62
+
63
+ ![](./docs/media/acp-integration.gif)
64
+
65
+ ### Zsh integration
66
+
67
+ You can use Kimi CLI together with Zsh, to empower your shell experience with AI agent capabilities.
68
+
69
+ Install the [zsh-kimi-cli](https://github.com/MoonshotAI/zsh-kimi-cli) plugin via:
70
+
71
+ ```sh
72
+ git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
73
+ ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli
74
+ ```
75
+
76
+ > [!NOTE]
77
+ > 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.
78
+
79
+ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
80
+
81
+ ```sh
82
+ plugins=(... kimi-cli)
83
+ ```
84
+
85
+ After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
86
+
87
+ ### MCP support
88
+
89
+ Kimi CLI supports MCP (Model Context Protocol) tools.
90
+
91
+ **`kimi mcp` sub-command group**
92
+
93
+ You can manage MCP servers with `kimi mcp` sub-command group. For example:
94
+
95
+ ```sh
96
+ # Add streamable HTTP server:
97
+ kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"
98
+
99
+ # Add streamable HTTP server with OAuth authorization:
100
+ kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
101
+
102
+ # Add stdio server:
103
+ kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
104
+
105
+ # List added MCP servers:
106
+ kimi mcp list
107
+
108
+ # Remove an MCP server:
109
+ kimi mcp remove chrome-devtools
110
+
111
+ # Authorize an MCP server:
112
+ kimi mcp auth linear
113
+ ```
114
+
115
+ **Ad-hoc MCP configuration**
116
+
117
+ Kimi CLI also supports ad-hoc MCP server configuration via CLI option.
118
+
119
+ Given an MCP config file in the well-known MCP config format like the following:
120
+
121
+ ```json
122
+ {
123
+ "mcpServers": {
124
+ "context7": {
125
+ "url": "https://mcp.context7.com/mcp",
126
+ "headers": {
127
+ "CONTEXT7_API_KEY": "YOUR_API_KEY"
128
+ }
129
+ },
130
+ "chrome-devtools": {
131
+ "command": "npx",
132
+ "args": ["-y", "chrome-devtools-mcp@latest"]
133
+ }
134
+ }
135
+ }
136
+ ```
137
+
138
+ Run `kimi` with `--mcp-config-file` option to connect to the specified MCP servers:
139
+
140
+ ```sh
141
+ kimi --mcp-config-file /path/to/mcp.json
142
+ ```
143
+
144
+ ### More
145
+
146
+ See more features in the [Documentation](https://moonshotai.github.io/kimi-cli/en/).
147
+
148
+ ## Development
149
+
150
+ To develop Kimi CLI, run:
151
+
152
+ ```sh
153
+ git clone https://github.com/MoonshotAI/kimi-cli.git
154
+ cd kimi-cli
155
+
156
+ make prepare # prepare the development environment
157
+ ```
158
+
159
+ Then you can start working on Kimi CLI.
160
+
161
+ Refer to the following commands after you make changes:
162
+
163
+ ```sh
164
+ uv run kimi # run Kimi CLI
165
+
166
+ make format # format code
167
+ make check # run linting and type checking
168
+ make test # run tests
169
+ make test-kimi-cli # run Kimi CLI tests only
170
+ make test-kosong # run kosong tests only
171
+ make test-pykaos # run pykaos tests only
172
+ make build # build python packages
173
+ make build-bin # build standalone binary
174
+ make help # show all make targets
175
+ ```
176
+
177
+ ## Contributing
178
+
179
+ We welcome contributions to Kimi CLI! Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.
@@ -0,0 +1,171 @@
1
+ # Kimi CLI
2
+
3
+ [![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
4
+ [![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
5
+ [![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
6
+ [![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
7
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/kimi-cli)
8
+
9
+ [Kimi Code](https://www.kimi.com/code/) | [Documentation](https://moonshotai.github.io/kimi-cli/en/) | [文档](https://moonshotai.github.io/kimi-cli/zh/)
10
+
11
+ Kimi CLI is an AI agent that runs in the terminal, helping you complete software development tasks and terminal operations. It can read and edit code, execute shell commands, search and fetch web pages, and autonomously plan and adjust actions during execution.
12
+
13
+ > [!IMPORTANT]
14
+ > Kimi CLI is currently in technical preview.
15
+
16
+ ## Getting Started
17
+
18
+ See [Getting Started](https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html) for how to install and start using Kimi CLI.
19
+
20
+ ## Key Features
21
+
22
+ ### Shell command mode
23
+
24
+ Kimi CLI is not only a coding agent, but also a shell. You can switch the shell command mode by pressing `Ctrl-X`. In this mode, you can directly run shell commands without leaving Kimi CLI.
25
+
26
+ ![](./docs/media/shell-mode.gif)
27
+
28
+ > [!NOTE]
29
+ > Built-in shell commands like `cd` are not supported yet.
30
+
31
+ ### IDE integration via ACP
32
+
33
+ Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
34
+
35
+ [Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
36
+
37
+ To use Kimi CLI with ACP clients, make sure to run Kimi CLI in the terminal and send `/setup` to complete the setup first. Then, you can configure your ACP client to start Kimi CLI as an ACP agent server with command `kimi acp`.
38
+
39
+ For example, to use Kimi CLI with [Zed](https://zed.dev/) or [JetBrains](https://blog.jetbrains.com/ai/2025/12/bring-your-own-ai-agent-to-jetbrains-ides/), add the following configuration to your `~/.config/zed/settings.json` or `~/.jetbrains/acp.json` file:
40
+
41
+ ```json
42
+ {
43
+ "agent_servers": {
44
+ "Kimi CLI": {
45
+ "command": "kimi",
46
+ "args": ["acp"],
47
+ "env": {}
48
+ }
49
+ }
50
+ }
51
+ ```
52
+
53
+ Then you can create Kimi CLI threads in IDE's agent panel.
54
+
55
+ ![](./docs/media/acp-integration.gif)
56
+
57
+ ### Zsh integration
58
+
59
+ You can use Kimi CLI together with Zsh, to empower your shell experience with AI agent capabilities.
60
+
61
+ Install the [zsh-kimi-cli](https://github.com/MoonshotAI/zsh-kimi-cli) plugin via:
62
+
63
+ ```sh
64
+ git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
65
+ ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli
66
+ ```
67
+
68
+ > [!NOTE]
69
+ > 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.
70
+
71
+ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
72
+
73
+ ```sh
74
+ plugins=(... kimi-cli)
75
+ ```
76
+
77
+ After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
78
+
79
+ ### MCP support
80
+
81
+ Kimi CLI supports MCP (Model Context Protocol) tools.
82
+
83
+ **`kimi mcp` sub-command group**
84
+
85
+ You can manage MCP servers with `kimi mcp` sub-command group. For example:
86
+
87
+ ```sh
88
+ # Add streamable HTTP server:
89
+ kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"
90
+
91
+ # Add streamable HTTP server with OAuth authorization:
92
+ kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
93
+
94
+ # Add stdio server:
95
+ kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
96
+
97
+ # List added MCP servers:
98
+ kimi mcp list
99
+
100
+ # Remove an MCP server:
101
+ kimi mcp remove chrome-devtools
102
+
103
+ # Authorize an MCP server:
104
+ kimi mcp auth linear
105
+ ```
106
+
107
+ **Ad-hoc MCP configuration**
108
+
109
+ Kimi CLI also supports ad-hoc MCP server configuration via CLI option.
110
+
111
+ Given an MCP config file in the well-known MCP config format like the following:
112
+
113
+ ```json
114
+ {
115
+ "mcpServers": {
116
+ "context7": {
117
+ "url": "https://mcp.context7.com/mcp",
118
+ "headers": {
119
+ "CONTEXT7_API_KEY": "YOUR_API_KEY"
120
+ }
121
+ },
122
+ "chrome-devtools": {
123
+ "command": "npx",
124
+ "args": ["-y", "chrome-devtools-mcp@latest"]
125
+ }
126
+ }
127
+ }
128
+ ```
129
+
130
+ Run `kimi` with `--mcp-config-file` option to connect to the specified MCP servers:
131
+
132
+ ```sh
133
+ kimi --mcp-config-file /path/to/mcp.json
134
+ ```
135
+
136
+ ### More
137
+
138
+ See more features in the [Documentation](https://moonshotai.github.io/kimi-cli/en/).
139
+
140
+ ## Development
141
+
142
+ To develop Kimi CLI, run:
143
+
144
+ ```sh
145
+ git clone https://github.com/MoonshotAI/kimi-cli.git
146
+ cd kimi-cli
147
+
148
+ make prepare # prepare the development environment
149
+ ```
150
+
151
+ Then you can start working on Kimi CLI.
152
+
153
+ Refer to the following commands after you make changes:
154
+
155
+ ```sh
156
+ uv run kimi # run Kimi CLI
157
+
158
+ make format # format code
159
+ make check # run linting and type checking
160
+ make test # run tests
161
+ make test-kimi-cli # run Kimi CLI tests only
162
+ make test-kosong # run kosong tests only
163
+ make test-pykaos # run pykaos tests only
164
+ make build # build python packages
165
+ make build-bin # build standalone binary
166
+ make help # show all make targets
167
+ ```
168
+
169
+ ## Contributing
170
+
171
+ We welcome contributions to Kimi CLI! Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.
@@ -0,0 +1,18 @@
1
+ [project]
2
+ name = "kimi-code"
3
+ version = "0.79"
4
+ description = "Kimi Code is a CLI agent that lives in your terminal."
5
+ readme = "README.md"
6
+ requires-python = ">=3.12"
7
+ dependencies = ["kimi-cli==0.79"]
8
+
9
+ [project.scripts]
10
+ kimi = "kimi_cli.cli:cli"
11
+ kimi-code = "kimi_cli.cli:cli"
12
+
13
+ [build-system]
14
+ requires = ["uv_build>=0.8.5,<0.10.0"]
15
+ build-backend = "uv_build"
16
+
17
+ [tool.uv.build-backend]
18
+ module-name = ["kimi_code"]
@@ -0,0 +1,7 @@
1
+ from __future__ import annotations
2
+
3
+ import importlib
4
+ import sys
5
+
6
+ # Alias the kimi_code package to kimi_cli for compatibility.
7
+ sys.modules[__name__] = importlib.import_module("kimi_cli")