kimi-cli 0.48__tar.gz

kimi_cli-0.48/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.3
+Name: kimi-cli
+Version: 0.48
+Summary: Kimi CLI is your next CLI agent.
+Requires-Dist: agent-client-protocol==0.6.3
+Requires-Dist: aiofiles==25.1.0
+Requires-Dist: aiohttp==3.13.2
+Requires-Dist: click==8.3.0
+Requires-Dist: kosong==0.18.0
+Requires-Dist: loguru==0.7.3
+Requires-Dist: patch-ng==1.19.0
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: pillow==12.0.0
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==14.2.0
+Requires-Dist: ripgrepy==2.2.0
+Requires-Dist: streamingjson==0.0.5
+Requires-Dist: trafilatura==2.0.0
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: fastmcp==2.12.5
+Requires-Dist: pydantic==2.12.3
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Kimi CLI
+
+[![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
+[![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
+[![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
+[![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/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:
+
+![](./docs/images/setup.png)
+
+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.

kimi_cli-0.48/README.md

@@ -0,0 +1,164 @@
+# Kimi CLI
+
+[![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
+[![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
+[![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
+[![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/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:
+
+![](./docs/images/setup.png)
+
+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.

kimi_cli-0.48/pyproject.toml

@@ -0,0 +1,66 @@
+[project]
+name = "kimi-cli"
+version = "0.48"
+description = "Kimi CLI is your next CLI agent."
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "agent-client-protocol==0.6.3",
+    "aiofiles==25.1.0",
+    "aiohttp==3.13.2",
+    "click==8.3.0",
+    "kosong==0.18.0",
+    "loguru==0.7.3",
+    "patch-ng==1.19.0",
+    "prompt-toolkit==3.0.52",
+    "pillow==12.0.0",
+    "pyyaml==6.0.3",
+    "rich==14.2.0",
+    "ripgrepy==2.2.0",
+    "streamingjson==0.0.5",
+    "trafilatura==2.0.0",
+    "tenacity==9.1.2",
+    "fastmcp==2.12.5",
+    "pydantic==2.12.3",
+    "httpx[socks]==0.28.1",
+]
+
+[dependency-groups]
+dev = [
+    "inline-snapshot[black]>=0.31.0",
+    "pyinstaller>=6.16.0",
+    "pyright>=1.1.407",
+    "pytest>=8.4.2",
+    "pytest-asyncio>=1.2.0",
+    "ruff>=0.14.1",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.5,<0.9.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = ["kimi_cli"]
+source-exclude = ["tests/**/*", "src/kimi_cli/deps/**/*"]
+
+[project.scripts]
+kimi = "kimi_cli.cli:main"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle
+    "F",   # Pyflakes
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "SIM", # flake8-simplify
+    "I",   # isort
+]
+
+[tool.typos.files]
+extend-exclude = ["kimi.spec", "pyinstaller.py"]
+
+[tool.typos.default.extend-words]
+datas = "datas"