kimi-cli 0.45__tar.gz → 0.51__tar.gz

{kimi_cli-0.45 → kimi_cli-0.51}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: kimi-cli
-Version: 0.45
+Version: 0.51
 Summary: Kimi CLI is your next CLI agent.
-Requires-Dist: agent-client-protocol==0.6.2
+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.16.2
+Requires-Dist: kosong==0.19.0
 Requires-Dist: loguru==0.7.3
 Requires-Dist: patch-ng==1.19.0
 Requires-Dist: prompt-toolkit==3.0.52
@@ -18,7 +18,7 @@ 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: pydantic==2.12.4
 Requires-Dist: httpx[socks]==0.28.1
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
@@ -29,6 +29,7 @@ Description-Content-Type: text/markdown
 [![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-0.45 → kimi_cli-0.51}/README.md

@@ -4,6 +4,7 @@
 [![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-0.45 → kimi_cli-0.51}/pyproject.toml

@@ -1,15 +1,15 @@
 [project]
 name = "kimi-cli"
-version = "0.45"
+version = "0.51"
 description = "Kimi CLI is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "agent-client-protocol==0.6.2",
+    "agent-client-protocol==0.6.3",
     "aiofiles==25.1.0",
     "aiohttp==3.13.2",
     "click==8.3.0",
-    "kosong==0.16.2",
+    "kosong==0.19.0",
     "loguru==0.7.3",
     "patch-ng==1.19.0",
     "prompt-toolkit==3.0.52",
@@ -21,18 +21,18 @@ dependencies = [
     "trafilatura==2.0.0",
     "tenacity==9.1.2",
     "fastmcp==2.12.5",
-    "pydantic==2.12.3",
+    "pydantic==2.12.4",
     "httpx[socks]==0.28.1",
 ]
 
 [dependency-groups]
 dev = [
-    "inline-snapshot[black]>=0.31.0",
+    "inline-snapshot[black]>=0.31.1",
     "pyinstaller>=6.16.0",
     "pyright>=1.1.407",
     "pytest>=8.4.2",
     "pytest-asyncio>=1.2.0",
-    "ruff>=0.14.1",
+    "ruff>=0.14.4",
 ]
 
 [build-system]

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/CHANGELOG.md

@@ -9,6 +9,58 @@ Internal builds may append content to the Unreleased section.
 Only write entries that are worth mentioning to users.
 -->
 
+## [0.51] - 2025-11-8
+
+- Lib: Rename `Soul.model` to `Soul.model_name`
+- Lib: Rename `LLMModelCapability` to `ModelCapability` and move to `kimi_cli.llm`
+- Lib: Add `"thinking"` to `ModelCapability`
+- Lib: Remove `LLM.supports_image_in` property
+- Lib: Add required `Soul.model_capabilities` property
+- Lib: Add `thinking: bool` parameter to `ShellApp.run` method
+- Lib: Rename `KimiSoul.set_thinking_mode` to `KimiSoul.set_thinking`
+- UI: Better checks and notices for LLM model capabilities
+- UI: Clear the screen for `/clear` meta command
+- Tool: Support auto-downloading ripgrep on Windows
+- CLI: Add `--thinking` option to start in thinking mode
+- ACP: Support thinking content in ACP mode
+
+## [0.50] - 2025-11-07
+
+### Changed
+
+- Improve UI look and feel
+- Improve Task tool observability
+
+## [0.49] - 2025-11-06
+
+### Fixed
+
+- Minor UX improvements
+
+## [0.48] - 2025-11-06
+
+### Added
+
+- Support Kimi K2 thinking mode
+
+## [0.47] - 2025-11-05
+
+### Fixed
+
+- Fix Ctrl-W not working in some environments
+- Do not load SearchWeb tool when the search service is not configured
+
+## [0.46] - 2025-11-03
+
+### Added
+
+- Introduce Wire over stdio for local IPC (experimental, subject to change)
+- Support Anthropic provider type
+
+### Fixed
+
+- Fix binary packed by PyInstaller not working due to wrong entrypoint
+
 ## [0.45] - 2025-10-31
 
 ### Added

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/app.py

@@ -12,6 +12,7 @@ from kimi_cli.cli import InputFormat, OutputFormat
 from kimi_cli.config import LLMModel, LLMProvider, load_config
 from kimi_cli.llm import augment_provider_with_env_vars, create_llm
 from kimi_cli.session import Session
+from kimi_cli.soul import LLMNotSet, LLMNotSupported
 from kimi_cli.soul.agent import load_agent
 from kimi_cli.soul.context import Context
 from kimi_cli.soul.kimisoul import KimiSoul
@@ -29,6 +30,7 @@ class KimiCLI:
         mcp_configs: list[dict[str, Any]] | None = None,
         config_file: Path | None = None,
         model_name: str | None = None,
+        thinking: bool = False,
         agent_file: Path | None = None,
     ) -> "KimiCLI":
         """
@@ -93,6 +95,10 @@ class KimiCLI:
             runtime,
             context=context,
         )
+        try:
+            soul.set_thinking(thinking)
+        except (LLMNotSet, LLMNotSupported) as e:
+            logger.warning("Failed to enable thinking mode: {error}", error=e)
         return KimiCLI(soul, runtime, env_overrides)
 
     def __init__(
@@ -127,7 +133,7 @@ class KimiCLI:
         finally:
             os.chdir(original_cwd)
 
-    async def run_shell_mode(self, command: str | None = None, markdown: bool = True) -> bool:
+    async def run_shell_mode(self, command: str | None = None) -> bool:
         from kimi_cli.ui.shell import ShellApp, WelcomeInfoItem
 
         welcome_info = [
@@ -154,7 +160,7 @@ class KimiCLI:
             welcome_info.append(
                 WelcomeInfoItem(
                     name="Model",
-                    value=f"{self._soul.model} (from KIMI_MODEL_NAME)",
+                    value=f"{self._soul.model_name} (from KIMI_MODEL_NAME)",
                     level=WelcomeInfoItem.Level.WARN,
                 )
             )
@@ -162,12 +168,12 @@ class KimiCLI:
             welcome_info.append(
                 WelcomeInfoItem(
                     name="Model",
-                    value=self._soul.model,
+                    value=self._soul.model_name,
                     level=WelcomeInfoItem.Level.INFO,
                 )
             )
         with self._app_env():
-            app = ShellApp(self._soul, welcome_info=welcome_info, markdown=markdown)
+            app = ShellApp(self._soul, welcome_info=welcome_info)
             return await app.run(command)
 
     async def run_print_mode(
@@ -193,3 +199,10 @@ class KimiCLI:
         with self._app_env():
             app = ACPServer(self._soul)
             return await app.run()
+
+    async def run_wire_server(self) -> bool:
+        from kimi_cli.ui.wire import WireServer
+
+        with self._app_env():
+            server = WireServer(self._soul)
+            return await server.run()

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/cli.py

@@ -16,7 +16,7 @@ class Reload(Exception):
     pass
 
 
-UIMode = Literal["shell", "print", "acp"]
+UIMode = Literal["shell", "print", "acp", "wire"]
 InputFormat = Literal["text", "stream-json"]
 OutputFormat = Literal["text", "stream-json"]
 
@@ -138,10 +138,10 @@ OutputFormat = Literal["text", "stream-json"]
     help="Automatically approve all actions. Default: no.",
 )
 @click.option(
-    "--markdown/--no-markdown",
+    "--thinking",
     is_flag=True,
-    default=True,
-    help="Enable/disable markdown rendering in shell UI. Default: yes.",
+    default=False,
+    help="Enable thinking mode if supported. Default: no.",
 )
 def kimi(
     verbose: bool,
@@ -157,7 +157,7 @@ def kimi(
     mcp_config_file: list[Path],
     mcp_config: list[str],
     yolo: bool,
-    markdown: bool,
+    thinking: bool,
 ):
     """Kimi, your next CLI agent."""
     from kimi_cli.app import KimiCLI
@@ -170,9 +170,12 @@ def kimi(
 
     echo: Callable[..., None] = click.echo if verbose else _noop_echo
 
+    if debug:
+        logger.enable("kosong")
     logger.add(
         get_share_dir() / "logs" / "kimi.log",
-        level="DEBUG" if debug else "INFO",
+        # FIXME: configure level for different modules
+        level="TRACE" if debug else "INFO",
         rotation="06:00",
         retention="10 days",
     )
@@ -223,11 +226,12 @@ def kimi(
             stream=ui != "print",  # use non-streaming mode only for print UI
             mcp_configs=mcp_configs,
             model_name=model_name,
+            thinking=thinking,
             agent_file=agent_file,
         )
         match ui:
             case "shell":
-                return await instance.run_shell_mode(command, markdown=markdown)
+                return await instance.run_shell_mode(command)
             case "print":
                 return await instance.run_print_mode(
                     input_format or "text",
@@ -238,6 +242,10 @@ def kimi(
                 if command is not None:
                     logger.warning("ACP server ignores command argument")
                 return await instance.run_acp_server()
+            case "wire":
+                if command is not None:
+                    logger.warning("Wire server ignores command argument")
+                return await instance.run_wire_server()
 
     while True:
         try:

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/config.py

@@ -1,10 +1,11 @@
 import json
 from pathlib import Path
-from typing import Literal, Self
+from typing import Self
 
 from pydantic import BaseModel, Field, SecretStr, ValidationError, field_serializer, model_validator
 
 from kimi_cli.exception import ConfigError
+from kimi_cli.llm import ModelCapability, ProviderType
 from kimi_cli.share import get_share_dir
 from kimi_cli.utils.logging import logger
 
@@ -12,7 +13,7 @@ from kimi_cli.utils.logging import logger
 class LLMProvider(BaseModel):
     """LLM provider configuration."""
 
-    type: Literal["kimi", "openai_legacy", "openai_responses", "_chaos"]
+    type: ProviderType
     """Provider type"""
     base_url: str
     """API base URL"""
@@ -26,9 +27,6 @@ class LLMProvider(BaseModel):
         return v.get_secret_value()
 
 
-LLMModelCapability = Literal["image_in"]
-
-
 class LLMModel(BaseModel):
     """LLM model configuration."""
 
@@ -38,7 +36,7 @@ class LLMModel(BaseModel):
     """Model name"""
     max_context_size: int
     """Maximum context size (unit: tokens)"""
-    capabilities: set[LLMModelCapability] | None = None
+    capabilities: set[ModelCapability] | None = None
     """Model capabilities"""
 
 

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/llm.py

@@ -1,29 +1,33 @@
 import os
-from typing import NamedTuple, cast, get_args
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Literal, cast, get_args
 
 from kosong.base.chat_provider import ChatProvider
 from pydantic import SecretStr
 
-from kimi_cli.config import LLMModel, LLMModelCapability, LLMProvider
 from kimi_cli.constant import USER_AGENT
 
+if TYPE_CHECKING:
+    from kimi_cli.config import LLMModel, LLMProvider
 
-class LLM(NamedTuple):
+type ProviderType = Literal["kimi", "openai_legacy", "openai_responses", "anthropic", "_chaos"]
+
+type ModelCapability = Literal["image_in", "thinking"]
+ALL_MODEL_CAPABILITIES: set[ModelCapability] = set(get_args(ModelCapability))
+
+
+@dataclass(slots=True)
+class LLM:
     chat_provider: ChatProvider
     max_context_size: int
-    capabilities: set[LLMModelCapability]
-    # TODO: these additional fields should be moved to ChatProvider
+    capabilities: set[ModelCapability]
 
     @property
     def model_name(self) -> str:
         return self.chat_provider.model_name
 
-    @property
-    def supports_image_in(self) -> bool:
-        return "image_in" in self.capabilities
 
-
-def augment_provider_with_env_vars(provider: LLMProvider, model: LLMModel) -> dict[str, str]:
+def augment_provider_with_env_vars(provider: "LLMProvider", model: "LLMModel") -> dict[str, str]:
     """Override provider/model settings from environment variables.
 
     Returns:
@@ -48,9 +52,9 @@ def augment_provider_with_env_vars(provider: LLMProvider, model: LLMModel) -> di
             if capabilities := os.getenv("KIMI_MODEL_CAPABILITIES"):
                 caps_lower = (cap.strip().lower() for cap in capabilities.split(",") if cap.strip())
                 model.capabilities = set(
-                    cast(LLMModelCapability, cap)
+                    cast(ModelCapability, cap)
                     for cap in caps_lower
-                    if cap in get_args(LLMModelCapability)
+                    if cap in get_args(ModelCapability)
                 )
                 applied["KIMI_MODEL_CAPABILITIES"] = capabilities
         case "openai_legacy" | "openai_responses":
@@ -65,8 +69,8 @@ def augment_provider_with_env_vars(provider: LLMProvider, model: LLMModel) -> di
 
 
 def create_llm(
-    provider: LLMProvider,
-    model: LLMModel,
+    provider: "LLMProvider",
+    model: "LLMModel",
     *,
     stream: bool = True,
     session_id: str | None = None,
@@ -88,7 +92,7 @@ def create_llm(
             if session_id:
                 chat_provider = chat_provider.with_generation_kwargs(prompt_cache_key=session_id)
         case "openai_legacy":
-            from kosong.chat_provider.openai_legacy import OpenAILegacy
+            from kosong.contrib.chat_provider.openai_legacy import OpenAILegacy
 
             chat_provider = OpenAILegacy(
                 model=model.model,
@@ -97,7 +101,7 @@ def create_llm(
                 stream=stream,
             )
         case "openai_responses":
-            from kosong.chat_provider.openai_responses import OpenAIResponses
+            from kosong.contrib.chat_provider.openai_responses import OpenAIResponses
 
             chat_provider = OpenAIResponses(
                 model=model.model,
@@ -105,6 +109,16 @@ def create_llm(
                 api_key=provider.api_key.get_secret_value(),
                 stream=stream,
             )
+        case "anthropic":
+            from kosong.contrib.chat_provider.anthropic import Anthropic
+
+            chat_provider = Anthropic(
+                model=model.model,
+                base_url=provider.base_url,
+                api_key=provider.api_key.get_secret_value(),
+                stream=stream,
+                default_max_tokens=50000,
+            )
         case "_chaos":
             from kosong.chat_provider.chaos import ChaosChatProvider, ChaosConfig
 
@@ -121,5 +135,15 @@ def create_llm(
     return LLM(
         chat_provider=chat_provider,
         max_context_size=model.max_context_size,
-        capabilities=model.capabilities or set(),
+        capabilities=_derive_capabilities(provider, model),
     )
+
+
+def _derive_capabilities(provider: "LLMProvider", model: "LLMModel") -> set[ModelCapability]:
+    capabilities = model.capabilities or set()
+    if provider.type != "kimi":
+        return capabilities
+
+    if model.model == "kimi-for-coding" or "thinking" in model.model:
+        capabilities.add("thinking")
+    return capabilities

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/metadata.py

@@ -23,7 +23,7 @@ class WorkDirMeta(BaseModel):
 
     @property
     def sessions_dir(self) -> Path:
-        path = get_share_dir() / "sessions" / md5(self.path.encode()).hexdigest()
+        path = get_share_dir() / "sessions" / md5(self.path.encode(encoding="utf-8")).hexdigest()
         path.mkdir(parents=True, exist_ok=True)
         return path
 

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/soul/__init__.py

@@ -2,15 +2,17 @@ import asyncio
 import contextlib
 from collections.abc import Callable, Coroutine
 from contextvars import ContextVar
-from typing import Any, NamedTuple, Protocol, runtime_checkable
+from typing import TYPE_CHECKING, Any, NamedTuple, Protocol, runtime_checkable
 
 from kosong.base.message import ContentPart
 
-from kimi_cli.llm import LLM
 from kimi_cli.utils.logging import logger
 from kimi_cli.wire import Wire, WireUISide
 from kimi_cli.wire.message import WireMessage
 
+if TYPE_CHECKING:
+    from kimi_cli.llm import LLM, ModelCapability
+
 
 class LLMNotSet(Exception):
     """Raised when the LLM is not set."""
@@ -21,12 +23,12 @@ class LLMNotSet(Exception):
 class LLMNotSupported(Exception):
     """Raised when the LLM does not have required capabilities."""
 
-    def __init__(self, llm: LLM, capabilities: list[str]):
+    def __init__(self, llm: "LLM", capabilities: "list[ModelCapability]"):
         self.llm = llm
         self.capabilities = capabilities
         capabilities_str = "capability" if len(capabilities) == 1 else "capabilities"
         super().__init__(
-            f"The LLM model '{llm.model_name}' does not support required {capabilities_str}: "
+            f"LLM model '{llm.model_name}' does not support required {capabilities_str}: "
             f"{', '.join(capabilities)}."
         )
 
@@ -54,8 +56,13 @@ class Soul(Protocol):
         ...
 
     @property
-    def model(self) -> str:
-        """The LLM model used by the soul. Empty string indicates no LLM configured."""
+    def model_name(self) -> str:
+        """The name of the LLM model used by the soul. Empty string indicates no LLM configured."""
+        ...
+
+    @property
+    def model_capabilities(self) -> "set[ModelCapability] | None":
+        """The capabilities of the LLM model used by the soul. None indicates no LLM configured."""
         ...
 
     @property
@@ -147,8 +154,8 @@ async def run_soul(
             pass
         except TimeoutError:
             logger.warning("UI loop timed out")
-
-        _current_wire.reset(wire_token)
+        finally:
+            _current_wire.reset(wire_token)
 
 
 _current_wire = ContextVar[Wire | None]("current_wire", default=None)

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/soul/agent.py

@@ -13,6 +13,7 @@ from kimi_cli.soul.approval import Approval
 from kimi_cli.soul.denwarenji import DenwaRenji
 from kimi_cli.soul.runtime import BuiltinSystemPromptArgs, Runtime
 from kimi_cli.soul.toolset import CustomToolset
+from kimi_cli.tools import SkipThisTool
 from kimi_cli.utils.logging import logger
 
 
@@ -99,7 +100,11 @@ def _load_tools(
 ) -> list[str]:
     bad_tools: list[str] = []
     for tool_path in tool_paths:
-        tool = _load_tool(tool_path, dependencies)
+        try:
+            tool = _load_tool(tool_path, dependencies)
+        except SkipThisTool:
+            logger.info("Skipping tool: {tool_path}", tool_path=tool_path)
+            continue
         if tool:
             toolset += tool
         else:

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/soul/kimisoul.py

@@ -6,6 +6,7 @@ from typing import TYPE_CHECKING
 import kosong
 import tenacity
 from kosong import StepResult
+from kosong.base.chat_provider import ThinkingEffort
 from kosong.base.message import ContentPart, ImageURLPart, Message
 from kosong.chat_provider import (
     APIConnectionError,
@@ -16,6 +17,7 @@ from kosong.chat_provider import (
 from kosong.tooling import ToolResult
 from tenacity import RetryCallState, retry_if_exception, stop_after_attempt, wait_exponential_jitter
 
+from kimi_cli.llm import ModelCapability
 from kimi_cli.soul import (
     LLMNotSet,
     LLMNotSupported,
@@ -71,6 +73,7 @@ class KimiSoul(Soul):
         self._reserved_tokens = RESERVED_TOKENS
         if self._runtime.llm is not None:
             assert self._reserved_tokens <= self._runtime.llm.max_context_size
+        self._thinking_effort: ThinkingEffort = "off"
 
         for tool in agent.toolset.tools:
             if tool.name == SendDMail_NAME:
@@ -84,9 +87,15 @@ class KimiSoul(Soul):
         return self._agent.name
 
     @property
-    def model(self) -> str:
+    def model_name(self) -> str:
         return self._runtime.llm.chat_provider.model_name if self._runtime.llm else ""
 
+    @property
+    def model_capabilities(self) -> set[ModelCapability] | None:
+        if self._runtime.llm is None:
+            return None
+        return self._runtime.llm.capabilities
+
     @property
     def status(self) -> StatusSnapshot:
         return StatusSnapshot(context_usage=self._context_usage)
@@ -101,6 +110,25 @@ class KimiSoul(Soul):
             return self._context.token_count / self._runtime.llm.max_context_size
         return 0.0
 
+    @property
+    def thinking(self) -> bool:
+        """Whether thinking mode is enabled."""
+        return self._thinking_effort != "off"
+
+    def set_thinking(self, enabled: bool) -> None:
+        """
+        Enable/disable thinking mode for the soul.
+
+        Raises:
+            LLMNotSet: When the LLM is not set.
+            LLMNotSupported: When the LLM does not support thinking mode.
+        """
+        if self._runtime.llm is None:
+            raise LLMNotSet()
+        if enabled and "thinking" not in self._runtime.llm.capabilities:
+            raise LLMNotSupported(self._runtime.llm, ["thinking"])
+        self._thinking_effort = "high" if enabled else "off"
+
     async def _checkpoint(self):
         await self._context.checkpoint(self._checkpoint_with_user_message)
 
@@ -111,7 +139,7 @@ class KimiSoul(Soul):
         if (
             isinstance(user_input, list)
             and any(isinstance(part, ImageURLPart) for part in user_input)
-            and not self._runtime.llm.supports_image_in
+            and "image_in" not in self._runtime.llm.capabilities
         ):
             raise LLMNotSupported(self._runtime.llm, ["image_in"])
 
@@ -187,7 +215,7 @@ class KimiSoul(Soul):
         async def _kosong_step_with_retry() -> StepResult:
             # run an LLM step (may be interrupted)
             return await kosong.step(
-                chat_provider,
+                chat_provider.with_thinking(self._thinking_effort),
                 self._agent.system_prompt,
                 self._agent.toolset,
                 self._context.history,

{kimi_cli-0.45 → kimi_cli-0.51}/src/kimi_cli/soul/toolset.py

@@ -2,7 +2,8 @@ from contextvars import ContextVar
 from typing import override
 
 from kosong.base.message import ToolCall
-from kosong.tooling import HandleResult, SimpleToolset
+from kosong.tooling import HandleResult
+from kosong.tooling.simple import SimpleToolset
 
 current_tool_call = ContextVar[ToolCall | None]("current_tool_call", default=None)