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

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

@@ -1,24 +1,25 @@
 Metadata-Version: 2.3
 Name: kimi-cli
-Version: 0.41
+Version: 0.51
 Summary: Kimi CLI is your next CLI agent.
-Requires-Dist: agent-client-protocol>=0.4.9
-Requires-Dist: aiofiles>=25.1.0
-Requires-Dist: aiohttp>=3.13.1
-Requires-Dist: click>=8.3.0
-Requires-Dist: kosong>=0.15.0
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: patch-ng>=1.19.0
-Requires-Dist: prompt-toolkit>=3.0.52
-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.0
+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.19.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.4
+Requires-Dist: httpx[socks]==0.28.1
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 
@@ -28,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)
 
@@ -84,7 +86,7 @@ After setup, Kimi CLI will be ready to use. You can send `/help` to get more inf
 
 ### Shell mode
 
-Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-K`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
+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.
@@ -109,7 +111,7 @@ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
 plugins=(... kimi-cli)
 ```
 
-After restarting Zsh, you can switch to agent mode by pressing `Ctrl-K`.
+After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
 
 ### ACP support
 

{kimi_cli-0.41 → 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)
 
@@ -60,7 +61,7 @@ After setup, Kimi CLI will be ready to use. You can send `/help` to get more inf
 
 ### Shell mode
 
-Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-K`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
+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.
@@ -85,7 +86,7 @@ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
 plugins=(... kimi-cli)
 ```
 
-After restarting Zsh, you can switch to agent mode by pressing `Ctrl-K`.
+After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
 
 ### ACP support
 

{kimi_cli-0.41 → kimi_cli-0.51}/pyproject.toml

@@ -1,37 +1,38 @@
 [project]
 name = "kimi-cli"
-version = "0.41"
+version = "0.51"
 description = "Kimi CLI is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "agent-client-protocol>=0.4.9",
-    "aiofiles>=25.1.0",
-    "aiohttp>=3.13.1",
-    "click>=8.3.0",
-    "kosong>=0.15.0",
-    "loguru>=0.7.3",
-    "patch-ng>=1.19.0",
-    "prompt-toolkit>=3.0.52",
-    "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.0",
+    "agent-client-protocol==0.6.3",
+    "aiofiles==25.1.0",
+    "aiohttp==3.13.2",
+    "click==8.3.0",
+    "kosong==0.19.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.4",
+    "httpx[socks]==0.28.1",
 ]
 
 [dependency-groups]
 dev = [
-    "inline-snapshot[black]>=0.30.1",
+    "inline-snapshot[black]>=0.31.1",
     "pyinstaller>=6.16.0",
-    "pyright>=1.1.406",
+    "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.41 → kimi_cli-0.51}/src/kimi_cli/CHANGELOG.md

@@ -9,6 +9,108 @@ 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
+
+- Allow `KIMI_MODEL_CAPABILITIES` environment variable to override model capabilities
+- Add `--no-markdown` option to disable markdown rendering
+- Support `openai_responses` LLM provider type
+
+### Fixed
+
+- Fix crash when continuing a session
+
+## [0.44] - 2025-10-30
+
+### Changed
+
+- Improve startup time
+
+### Fixed
+
+- Fix potential invalid bytes in user input
+
+## [0.43] - 2025-10-30
+
+### Added
+
+- Basic Windows support (experimental)
+- Display warnings when base URL or API key is overridden in environment variables
+- Support image input if the LLM model supports it
+- Replay recent context history when continuing a session
+
+### Fixed
+
+- Ensure new line after executing shell commands
+
+## [0.42] - 2025-10-28
+
+### Added
+
+- Support Ctrl-J or Alt-Enter to insert a new line
+
+### Changed
+
+- Change mode switch shortcut from Ctrl-K to Ctrl-X
+- Improve overall robustness
+
+### Fixed
+
+- Fix ACP server `no attribute` error
+
 ## [0.41] - 2025-10-26
 
 ### Fixed

{kimi_cli-0.41/src/kimi_cli/agents/koder → kimi_cli-0.51/src/kimi_cli/agents/default}/agent.yaml

@@ -19,6 +19,6 @@ agent:
     - "kimi_cli.tools.web:SearchWeb"
     - "kimi_cli.tools.web:FetchURL"
   subagents:
-    koder:
+    coder:
       path: ./sub.yaml
       description: "Good at general software engineering tasks."

{kimi_cli-0.41 → kimi_cli-0.51}/src/kimi_cli/agentspec.py

@@ -4,12 +4,14 @@ from typing import Any, NamedTuple
 import yaml
 from pydantic import BaseModel, Field
 
+from kimi_cli.exception import AgentSpecError
+
 
 def get_agents_dir() -> Path:
     return Path(__file__).parent / "agents"
 
 
-DEFAULT_AGENT_FILE = get_agents_dir() / "koder" / "agent.yaml"
+DEFAULT_AGENT_FILE = get_agents_dir() / "default" / "agent.yaml"
 
 
 class AgentSpec(BaseModel):
@@ -47,15 +49,21 @@ class ResolvedAgentSpec(NamedTuple):
 
 
 def load_agent_spec(agent_file: Path) -> ResolvedAgentSpec:
-    """Load agent specification from file."""
+    """
+    Load agent specification from file.
+
+    Raises:
+        FileNotFoundError: If the agent spec file is not found.
+        AgentSpecError: If the agent spec is not valid.
+    """
     agent_spec = _load_agent_spec(agent_file)
     assert agent_spec.extend is None, "agent extension should be recursively resolved"
     if agent_spec.name is None:
-        raise ValueError("Agent name is required")
+        raise AgentSpecError("Agent name is required")
     if agent_spec.system_prompt_path is None:
-        raise ValueError("System prompt path is required")
+        raise AgentSpecError("System prompt path is required")
     if agent_spec.tools is None:
-        raise ValueError("Tools are required")
+        raise AgentSpecError("Tools are required")
     return ResolvedAgentSpec(
         name=agent_spec.name,
         system_prompt_path=agent_spec.system_prompt_path,
@@ -68,12 +76,15 @@ def load_agent_spec(agent_file: Path) -> ResolvedAgentSpec:
 
 def _load_agent_spec(agent_file: Path) -> AgentSpec:
     assert agent_file.is_file(), "expect agent file to exist"
-    with open(agent_file, encoding="utf-8") as f:
-        data: dict[str, Any] = yaml.safe_load(f)
+    try:
+        with open(agent_file, encoding="utf-8") as f:
+            data: dict[str, Any] = yaml.safe_load(f)
+    except yaml.YAMLError as e:
+        raise AgentSpecError(f"Invalid YAML in agent spec file: {e}") from e
 
     version = data.get("version", 1)
     if version != 1:
-        raise ValueError(f"Unsupported agent spec version: {version}")
+        raise AgentSpecError(f"Unsupported agent spec version: {version}")
 
     agent_spec = AgentSpec(**data.get("agent", {}))
     if agent_spec.system_prompt_path is not None:

kimi_cli-0.51/src/kimi_cli/app.py

@@ -0,0 +1,208 @@
+import contextlib
+import os
+import warnings
+from collections.abc import Generator
+from pathlib import Path
+from typing import Any
+
+from pydantic import SecretStr
+
+from kimi_cli.agentspec import DEFAULT_AGENT_FILE
+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
+from kimi_cli.soul.runtime import Runtime
+from kimi_cli.utils.logging import StreamToLogger, logger
+
+
+class KimiCLI:
+    @staticmethod
+    async def create(
+        session: Session,
+        *,
+        yolo: bool = False,
+        stream: bool = True,  # TODO: remove this when we have a correct print mode impl
+        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":
+        """
+        Create a KimiCLI instance.
+
+        Args:
+            session (Session): A session created by `Session.create` or `Session.continue_`.
+            yolo (bool, optional): Approve all actions without confirmation. Defaults to False.
+            stream (bool, optional): Use stream mode when calling LLM API. Defaults to True.
+            config_file (Path | None, optional): Path to the configuration file. Defaults to None.
+            model_name (str | None, optional): Name of the model to use. Defaults to None.
+            agent_file (Path | None, optional): Path to the agent file. Defaults to None.
+
+        Raises:
+            FileNotFoundError: When the agent file is not found.
+            ConfigError(KimiCLIException): When the configuration is invalid.
+            AgentSpecError(KimiCLIException): When the agent specification is invalid.
+        """
+        config = load_config(config_file)
+        logger.info("Loaded config: {config}", config=config)
+
+        model: LLMModel | None = None
+        provider: LLMProvider | None = None
+
+        # try to use config file
+        if not model_name and config.default_model:
+            # no --model specified && default model is set in config
+            model = config.models[config.default_model]
+            provider = config.providers[model.provider]
+        if model_name and model_name in config.models:
+            # --model specified && model is set in config
+            model = config.models[model_name]
+            provider = config.providers[model.provider]
+
+        if not model:
+            model = LLMModel(provider="", model="", max_context_size=100_000)
+            provider = LLMProvider(type="kimi", base_url="", api_key=SecretStr(""))
+
+        # try overwrite with environment variables
+        assert provider is not None
+        assert model is not None
+        env_overrides = augment_provider_with_env_vars(provider, model)
+
+        if not provider.base_url or not model.model:
+            llm = None
+        else:
+            logger.info("Using LLM provider: {provider}", provider=provider)
+            logger.info("Using LLM model: {model}", model=model)
+            llm = create_llm(provider, model, stream=stream, session_id=session.id)
+
+        runtime = await Runtime.create(config, llm, session, yolo)
+
+        if agent_file is None:
+            agent_file = DEFAULT_AGENT_FILE
+        agent = await load_agent(agent_file, runtime, mcp_configs=mcp_configs or [])
+
+        context = Context(session.history_file)
+        await context.restore()
+
+        soul = KimiSoul(
+            agent,
+            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__(
+        self,
+        _soul: KimiSoul,
+        _runtime: Runtime,
+        _env_overrides: dict[str, str],
+    ) -> None:
+        self._soul = _soul
+        self._runtime = _runtime
+        self._env_overrides = _env_overrides
+
+    @property
+    def soul(self) -> KimiSoul:
+        """Get the KimiSoul instance."""
+        return self._soul
+
+    @property
+    def session(self) -> Session:
+        """Get the Session instance."""
+        return self._runtime.session
+
+    @contextlib.contextmanager
+    def _app_env(self) -> Generator[None]:
+        original_cwd = Path.cwd()
+        os.chdir(self._runtime.session.work_dir)
+        try:
+            # to ignore possible warnings from dateparser
+            warnings.filterwarnings("ignore", category=DeprecationWarning)
+            with contextlib.redirect_stderr(StreamToLogger()):
+                yield
+        finally:
+            os.chdir(original_cwd)
+
+    async def run_shell_mode(self, command: str | None = None) -> bool:
+        from kimi_cli.ui.shell import ShellApp, WelcomeInfoItem
+
+        welcome_info = [
+            WelcomeInfoItem(name="Directory", value=str(self._runtime.session.work_dir)),
+            WelcomeInfoItem(name="Session", value=self._runtime.session.id),
+        ]
+        if base_url := self._env_overrides.get("KIMI_BASE_URL"):
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="API URL",
+                    value=f"{base_url} (from KIMI_BASE_URL)",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        if not self._runtime.llm:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value="not set, send /setup to configure",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        elif "KIMI_MODEL_NAME" in self._env_overrides:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value=f"{self._soul.model_name} (from KIMI_MODEL_NAME)",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        else:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value=self._soul.model_name,
+                    level=WelcomeInfoItem.Level.INFO,
+                )
+            )
+        with self._app_env():
+            app = ShellApp(self._soul, welcome_info=welcome_info)
+            return await app.run(command)
+
+    async def run_print_mode(
+        self,
+        input_format: InputFormat,
+        output_format: OutputFormat,
+        command: str | None = None,
+    ) -> bool:
+        from kimi_cli.ui.print import PrintApp
+
+        with self._app_env():
+            app = PrintApp(
+                self._soul,
+                input_format,
+                output_format,
+                self._runtime.session.history_file,
+            )
+            return await app.run(command)
+
+    async def run_acp_server(self) -> bool:
+        from kimi_cli.ui.acp import ACPServer
+
+        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()