kimi-cli 0.77__tar.gz

kimi_cli-0.77/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.3
+Name: kimi-cli
+Version: 0.77
+Summary: Kimi CLI is your next CLI agent.
+Requires-Dist: agent-client-protocol==0.7.0
+Requires-Dist: aiofiles>=24.0,<26.0
+Requires-Dist: aiohttp==3.13.3
+Requires-Dist: typer==0.21.1
+Requires-Dist: kosong[contrib]==0.38.0
+Requires-Dist: loguru>=0.6.0,<0.8
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: pillow==12.1.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: lxml==6.0.2
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: fastmcp==2.12.5
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Dist: pykaos==0.6.0
+Requires-Dist: batrachian-toad==0.5.23 ; python_full_version >= '3.14'
+Requires-Dist: tomlkit==0.13.3
+Requires-Dist: jinja2==3.1.4
+Requires-Python: >=3.12
+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)
+
+[Kimi Code](https://www.kimi.com/code/) | [Documentation](https://moonshotai.github.io/kimi-cli/en/) | [文档](https://moonshotai.github.io/kimi-cli/zh/)
+
+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.
+
+> [!IMPORTANT]
+> Kimi CLI is currently in technical preview.
+
+## Getting Started
+
+See [Getting Started](https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html) for how to install and start using Kimi CLI.
+
+## Key Features
+
+### Shell command mode
+
+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.
+
+![](./docs/media/shell-mode.gif)
+
+> [!NOTE]
+> Built-in shell commands like `cd` are not supported yet.
+
+### IDE integration via ACP
+
+Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
+
+[Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
+
+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`.
+
+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:
+
+```json
+{
+  "agent_servers": {
+    "Kimi CLI": {
+      "command": "kimi",
+      "args": ["acp"],
+      "env": {}
+    }
+  }
+}
+```
+
+Then you can create Kimi CLI threads in IDE's agent panel.
+
+![](./docs/media/acp-integration.gif)
+
+### 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`.
+
+### MCP support
+
+Kimi CLI supports MCP (Model Context Protocol) tools.
+
+**`kimi mcp` sub-command group**
+
+You can manage MCP servers with `kimi mcp` sub-command group. For example:
+
+```sh
+# Add streamable HTTP server:
+kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"
+
+# Add streamable HTTP server with OAuth authorization:
+kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
+
+# Add stdio server:
+kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
+
+# List added MCP servers:
+kimi mcp list
+
+# Remove an MCP server:
+kimi mcp remove chrome-devtools
+
+# Authorize an MCP server:
+kimi mcp auth linear
+```
+
+**Ad-hoc MCP configuration**
+
+Kimi CLI also supports ad-hoc MCP server configuration via CLI option.
+
+Given an MCP config file in the well-known MCP config format like the following:
+
+```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
+```
+
+### More
+
+See more features in the [Documentation](https://moonshotai.github.io/kimi-cli/en/).
+
+## 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 test-kimi-cli  # run Kimi CLI tests only
+make test-kosong  # run kosong tests only
+make test-pykaos  # run pykaos tests only
+make build  # build python packages
+make build-bin  # build standalone binary
+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.77/README.md

@@ -0,0 +1,171 @@
+# 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)
+
+[Kimi Code](https://www.kimi.com/code/) | [Documentation](https://moonshotai.github.io/kimi-cli/en/) | [文档](https://moonshotai.github.io/kimi-cli/zh/)
+
+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.
+
+> [!IMPORTANT]
+> Kimi CLI is currently in technical preview.
+
+## Getting Started
+
+See [Getting Started](https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html) for how to install and start using Kimi CLI.
+
+## Key Features
+
+### Shell command mode
+
+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.
+
+![](./docs/media/shell-mode.gif)
+
+> [!NOTE]
+> Built-in shell commands like `cd` are not supported yet.
+
+### IDE integration via ACP
+
+Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
+
+[Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
+
+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`.
+
+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:
+
+```json
+{
+  "agent_servers": {
+    "Kimi CLI": {
+      "command": "kimi",
+      "args": ["acp"],
+      "env": {}
+    }
+  }
+}
+```
+
+Then you can create Kimi CLI threads in IDE's agent panel.
+
+![](./docs/media/acp-integration.gif)
+
+### 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`.
+
+### MCP support
+
+Kimi CLI supports MCP (Model Context Protocol) tools.
+
+**`kimi mcp` sub-command group**
+
+You can manage MCP servers with `kimi mcp` sub-command group. For example:
+
+```sh
+# Add streamable HTTP server:
+kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"
+
+# Add streamable HTTP server with OAuth authorization:
+kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
+
+# Add stdio server:
+kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
+
+# List added MCP servers:
+kimi mcp list
+
+# Remove an MCP server:
+kimi mcp remove chrome-devtools
+
+# Authorize an MCP server:
+kimi mcp auth linear
+```
+
+**Ad-hoc MCP configuration**
+
+Kimi CLI also supports ad-hoc MCP server configuration via CLI option.
+
+Given an MCP config file in the well-known MCP config format like the following:
+
+```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
+```
+
+### More
+
+See more features in the [Documentation](https://moonshotai.github.io/kimi-cli/en/).
+
+## 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 test-kimi-cli  # run Kimi CLI tests only
+make test-kosong  # run kosong tests only
+make test-pykaos  # run pykaos tests only
+make build  # build python packages
+make build-bin  # build standalone binary
+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.77/pyproject.toml

@@ -0,0 +1,93 @@
+[project]
+name = "kimi-cli"
+version = "0.77"
+description = "Kimi CLI is your next CLI agent."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "agent-client-protocol==0.7.0",
+    "aiofiles>=24.0,<26.0",
+    "aiohttp==3.13.3",
+    "typer==0.21.1",
+    "kosong[contrib]==0.38.0",
+    # loguru stays >=0.6.0 because notify-py (via batrachian-toad) caps it at <=0.6.0 on 3.14+.
+    "loguru>=0.6.0,<0.8",
+    "prompt-toolkit==3.0.52",
+    "pillow==12.1.0",
+    "pyyaml==6.0.3",
+    "rich==14.2.0",
+    "ripgrepy==2.2.0",
+    "streamingjson==0.0.5",
+    "trafilatura==2.0.0",
+    # lxml is used by trafilatura/htmldate/justext; keep pinned for binary wheels.
+    "lxml==6.0.2",
+    "tenacity==9.1.2",
+    "fastmcp==2.12.5",
+    "pydantic==2.12.5",
+    "httpx[socks]==0.28.1",
+    "pykaos==0.6.0",
+    "batrachian-toad==0.5.23; python_version >= \"3.14\"",
+    "tomlkit==0.13.3",
+    "jinja2==3.1.4",
+]
+
+[dependency-groups]
+dev = [
+    "pyinstaller==6.17.0",
+    "inline-snapshot[black]>=0.31.1",
+    "pyright>=1.1.407",
+    "ty>=0.0.9",
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.3.0",
+    "ruff>=0.14.10",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.5,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = ["kimi_cli"]
+source-exclude = ["examples/**/*", "tests/**/*", "src/kimi_cli/deps/**/*"]
+
+[tool.uv.workspace]
+members = ["packages/kosong", "packages/kaos", "sdks/kimi-sdk"]
+
+[tool.uv.sources]
+kosong = { workspace = true }
+pykaos = { workspace = true }
+
+[project.scripts]
+kimi = "kimi_cli.cli:cli"
+kimi-cli = "kimi_cli.cli:cli"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle
+    "F",   # Pyflakes
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "SIM", # flake8-simplify
+    "I",   # isort
+]
+
+[tool.pyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.14"
+include = ["src/**/*.py", "tests/**/*.py", "tests_ai/scripts/**/*.py"]
+strict = ["src/kimi_cli/**/*.py"]
+
+[tool.ty.environment]
+python-version = "3.14"
+
+[tool.ty.src]
+include = ["src/**/*.py", "tests/**/*.py", "tests_ai/scripts/**/*.py"]
+
+[tool.typos.files]
+extend-exclude = ["kimi.spec", "pyinstaller.py"]
+
+[tool.typos.default.extend-words]
+datas = "datas"