klaude-code 1.2.26__tar.gz → 1.2.28__tar.gz

{klaude_code-1.2.26 → klaude_code-1.2.28}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 1.2.26
-Summary: Add your description here
+Version: 1.2.28
+Summary: Minimal code agent CLI
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: chardet>=5.2.0
 Requires-Dist: ddgs>=9.9.3
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 
 # Klaude Code
 
-Multi-model code agent CLI.
+Minimal code agent CLI.
 
 ## Features
 - **Multi-provider**: Anthropic, OpenAI Responses API, OpenRouter
@@ -92,147 +92,141 @@ klaude [--model <name>] [--select-model]
 
 ### Configuration
 
-An example config will be created in `~/.klaude/klaude-config.yaml` when first run.
+#### Quick Start (Zero Config)
 
-Open the configuration file in editor:
+Klaude comes with built-in provider configurations. Just set an API key environment variable and start using it:
+
+```bash
+# Pick one (or more) of these:
+export ANTHROPIC_API_KEY=sk-ant-xxx      # Claude models
+export OPENAI_API_KEY=sk-xxx             # GPT models
+export OPENROUTER_API_KEY=sk-or-xxx      # OpenRouter (multi-provider)
+export DEEPSEEK_API_KEY=sk-xxx           # DeepSeek models
+export MOONSHOT_API_KEY=sk-xxx           # Moonshot/Kimi models
+
+# Then just run:
+klaude
+```
+
+On first run, you'll be prompted to select a model. Your choice is saved as `main_model`.
+
+#### Built-in Providers
+
+| Provider    | Env Variable          | Models                                                                        |
+|-------------|-----------------------|-------------------------------------------------------------------------------|
+| anthropic   | `ANTHROPIC_API_KEY`   | sonnet, opus                                                                  |
+| openai      | `OPENAI_API_KEY`      | gpt-5.2                                                                       |
+| openrouter  | `OPENROUTER_API_KEY`  | gpt-5.2, gpt-5.2-fast, gpt-5.1-codex-max, sonnet, opus, haiku, kimi, gemini-* |
+| deepseek    | `DEEPSEEK_API_KEY`    | deepseek                                                                      |
+| moonshot    | `MOONSHOT_API_KEY`    | kimi@moonshot                                                                 |
+| codex       | N/A (OAuth)           | gpt-5.2-codex                                                                 |
+
+List all configured providers and models:
+
+```bash
+klaude list
+```
+
+Models from providers without a valid API key are shown as dimmed/unavailable.
+
+#### Custom Configuration
+
+User config file: `~/.klaude/klaude-config.yaml`
+
+Open in editor:
 
 ```bash
 klaude config
 ```
 
-An example config yaml:
+##### Adding Models to Built-in Providers
+
+You can add custom models to existing providers without redefining the entire provider:
 
 ```yaml
+# Just specify provider_name and your new models - no need for protocol/api_key
 provider_list:
-- provider_name: openrouter
-  protocol: openrouter # support <responses|openrouter|anthropic|openai>
-  api_key: <your-openrouter-api-key>
-
-- provider_name: openai-responses
-  protocol: responses
-  api_key: <your-openai-api-key>
-
-- provider_name: anthropic
-  protocol: anthropic
-  api_key: <your-anthropic-api-key>
-
-- provider_name: moonshot
-  protocol: anthropic
-  base_url: https://api.moonshot.cn/anthropic
-  api_key: <your-api-key>
-
-- provider_name: deepseek
-  protocol: anthropic
-  base_url: https://api.deepseek.com/anthropic
-  api_key: <your-api-key>
-
-model_list:
-
-- model_name: deepseek
-  provider: deepseek
-  model_params:
-    model: deepseek-reasoner
-    context_limit: 128000
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 2
-      output: 3
-      cache_read: 0.2
-
-- model_name: codex-max
-  provider: openai-responses
-  model_params:
-    model: gpt-5.1-codex-max
-    thinking:
-      reasoning_effort: medium
-    context_limit: 400000
-    max_tokens: 128000
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: gpt-5.1
-  provider: openrouter
-  model_params:
-    model: openai/gpt-5.1
-    context_limit: 400000
-    max_tokens: 128000
-    verbosity: high
-    thinking:
-      reasoning_effort: high
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: kimi@moonshot
-  provider: moonshot
-  model_params:
-    model: kimi-k2-thinking
-    context_limit: 262144
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 4
-      output: 16
-      cache_read: 1
-
-- model_name: opus
-  provider: openrouter
-  model_params:
-    model: anthropic/claude-4.5-opus
-    context_limit: 200000
-    provider_routing:
-      only: [ google-vertex ]
-    verbosity: high
-    thinking:
-      type: enabled
-      budget_tokens: 31999
-    cost:
-      input: 5
-      output: 25
-      cache_read: 0.5
-      cache_write: 6.25
-
-- model_name: gemini
-  provider: openrouter
-  model_params:
-    model: google/gemini-3-pro-preview
-    context_limit: 1048576
-    thinking:
-      reasoning_effort: medium
-    cost:
-      input: 2
-      output: 12
-      cache_read: 0.2
-
-- model_name: haiku
-  provider: anthropic
-  model_params:
-    model: claude-haiku-4-5-20251001
-    context_limit: 200000
-    cost:
-      input: 1
-      output: 5
-      cache_read: 0.1
-      cache_write: 1.25
+  - provider_name: openrouter
+    model_list:
+      - model_name: my-custom-model
+        model_params:
+          model: some-provider/some-model-id
+          context_limit: 200000
+```
+
+Your models are merged with built-in models. To override a built-in model, use the same `model_name`.
 
+##### Overriding Provider Settings
+
+Override provider-level settings (like api_key) while keeping built-in models:
+
+```yaml
+provider_list:
+  - provider_name: anthropic
+    api_key: sk-my-custom-key  # Override the default ${ANTHROPIC_API_KEY}
+    # Built-in models (sonnet, opus) are still available
+```
+
+##### Adding New Providers
+
+For providers not in the built-in list, you must specify `protocol`:
+
+```yaml
+provider_list:
+  - provider_name: my-azure-openai
+    protocol: openai
+    api_key: ${AZURE_OPENAI_KEY}
+    base_url: https://my-instance.openai.azure.com/
+    is_azure: true
+    azure_api_version: "2024-02-15-preview"
+    model_list:
+      - model_name: gpt-4-azure
+        model_params:
+          model: gpt-4
+          context_limit: 128000
+```
+
+##### Full Example
+
+```yaml
+# User configuration - merged with built-in config
 main_model: opus
 
 sub_agent_models:
-  oracle: gpt-5.1
-  explore: haiku
+  oracle: gpt-4.1
+  explore: sonnet
   task: opus
-  webagent: haiku
+  webagent: sonnet
 
+provider_list:
+  # Add models to built-in openrouter
+  - provider_name: openrouter
+    model_list:
+      - model_name: qwen-coder
+        model_params:
+          model: qwen/qwen-2.5-coder-32b-instruct
+          context_limit: 131072
+
+  # Add a completely new provider
+  - provider_name: local-ollama
+    protocol: openai
+    base_url: http://localhost:11434/v1
+    api_key: ollama
+    model_list:
+      - model_name: local-llama
+        model_params:
+          model: llama3.2
+          context_limit: 8192
 ```
 
+##### Supported Protocols
+
+- `anthropic` - Anthropic Claude API
+- `openai` - OpenAI-compatible API
+- `responses` - OpenAI Responses API (for o-series, GPT-5, Codex)
+- `openrouter` - OpenRouter API
+- `codex` - OpenAI Codex CLI (OAuth-based)
+
 List configured providers and models:
 
 ```bash

{klaude_code-1.2.26 → klaude_code-1.2.28}/README.md

@@ -1,6 +1,6 @@
 # Klaude Code
 
-Multi-model code agent CLI.
+Minimal code agent CLI.
 
 ## Features
 - **Multi-provider**: Anthropic, OpenAI Responses API, OpenRouter
@@ -71,147 +71,141 @@ klaude [--model <name>] [--select-model]
 
 ### Configuration
 
-An example config will be created in `~/.klaude/klaude-config.yaml` when first run.
+#### Quick Start (Zero Config)
 
-Open the configuration file in editor:
+Klaude comes with built-in provider configurations. Just set an API key environment variable and start using it:
+
+```bash
+# Pick one (or more) of these:
+export ANTHROPIC_API_KEY=sk-ant-xxx      # Claude models
+export OPENAI_API_KEY=sk-xxx             # GPT models
+export OPENROUTER_API_KEY=sk-or-xxx      # OpenRouter (multi-provider)
+export DEEPSEEK_API_KEY=sk-xxx           # DeepSeek models
+export MOONSHOT_API_KEY=sk-xxx           # Moonshot/Kimi models
+
+# Then just run:
+klaude
+```
+
+On first run, you'll be prompted to select a model. Your choice is saved as `main_model`.
+
+#### Built-in Providers
+
+| Provider    | Env Variable          | Models                                                                        |
+|-------------|-----------------------|-------------------------------------------------------------------------------|
+| anthropic   | `ANTHROPIC_API_KEY`   | sonnet, opus                                                                  |
+| openai      | `OPENAI_API_KEY`      | gpt-5.2                                                                       |
+| openrouter  | `OPENROUTER_API_KEY`  | gpt-5.2, gpt-5.2-fast, gpt-5.1-codex-max, sonnet, opus, haiku, kimi, gemini-* |
+| deepseek    | `DEEPSEEK_API_KEY`    | deepseek                                                                      |
+| moonshot    | `MOONSHOT_API_KEY`    | kimi@moonshot                                                                 |
+| codex       | N/A (OAuth)           | gpt-5.2-codex                                                                 |
+
+List all configured providers and models:
+
+```bash
+klaude list
+```
+
+Models from providers without a valid API key are shown as dimmed/unavailable.
+
+#### Custom Configuration
+
+User config file: `~/.klaude/klaude-config.yaml`
+
+Open in editor:
 
 ```bash
 klaude config
 ```
 
-An example config yaml:
+##### Adding Models to Built-in Providers
+
+You can add custom models to existing providers without redefining the entire provider:
 
 ```yaml
+# Just specify provider_name and your new models - no need for protocol/api_key
 provider_list:
-- provider_name: openrouter
-  protocol: openrouter # support <responses|openrouter|anthropic|openai>
-  api_key: <your-openrouter-api-key>
-
-- provider_name: openai-responses
-  protocol: responses
-  api_key: <your-openai-api-key>
-
-- provider_name: anthropic
-  protocol: anthropic
-  api_key: <your-anthropic-api-key>
-
-- provider_name: moonshot
-  protocol: anthropic
-  base_url: https://api.moonshot.cn/anthropic
-  api_key: <your-api-key>
-
-- provider_name: deepseek
-  protocol: anthropic
-  base_url: https://api.deepseek.com/anthropic
-  api_key: <your-api-key>
-
-model_list:
-
-- model_name: deepseek
-  provider: deepseek
-  model_params:
-    model: deepseek-reasoner
-    context_limit: 128000
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 2
-      output: 3
-      cache_read: 0.2
-
-- model_name: codex-max
-  provider: openai-responses
-  model_params:
-    model: gpt-5.1-codex-max
-    thinking:
-      reasoning_effort: medium
-    context_limit: 400000
-    max_tokens: 128000
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: gpt-5.1
-  provider: openrouter
-  model_params:
-    model: openai/gpt-5.1
-    context_limit: 400000
-    max_tokens: 128000
-    verbosity: high
-    thinking:
-      reasoning_effort: high
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: kimi@moonshot
-  provider: moonshot
-  model_params:
-    model: kimi-k2-thinking
-    context_limit: 262144
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 4
-      output: 16
-      cache_read: 1
-
-- model_name: opus
-  provider: openrouter
-  model_params:
-    model: anthropic/claude-4.5-opus
-    context_limit: 200000
-    provider_routing:
-      only: [ google-vertex ]
-    verbosity: high
-    thinking:
-      type: enabled
-      budget_tokens: 31999
-    cost:
-      input: 5
-      output: 25
-      cache_read: 0.5
-      cache_write: 6.25
-
-- model_name: gemini
-  provider: openrouter
-  model_params:
-    model: google/gemini-3-pro-preview
-    context_limit: 1048576
-    thinking:
-      reasoning_effort: medium
-    cost:
-      input: 2
-      output: 12
-      cache_read: 0.2
-
-- model_name: haiku
-  provider: anthropic
-  model_params:
-    model: claude-haiku-4-5-20251001
-    context_limit: 200000
-    cost:
-      input: 1
-      output: 5
-      cache_read: 0.1
-      cache_write: 1.25
+  - provider_name: openrouter
+    model_list:
+      - model_name: my-custom-model
+        model_params:
+          model: some-provider/some-model-id
+          context_limit: 200000
+```
+
+Your models are merged with built-in models. To override a built-in model, use the same `model_name`.
 
+##### Overriding Provider Settings
+
+Override provider-level settings (like api_key) while keeping built-in models:
+
+```yaml
+provider_list:
+  - provider_name: anthropic
+    api_key: sk-my-custom-key  # Override the default ${ANTHROPIC_API_KEY}
+    # Built-in models (sonnet, opus) are still available
+```
+
+##### Adding New Providers
+
+For providers not in the built-in list, you must specify `protocol`:
+
+```yaml
+provider_list:
+  - provider_name: my-azure-openai
+    protocol: openai
+    api_key: ${AZURE_OPENAI_KEY}
+    base_url: https://my-instance.openai.azure.com/
+    is_azure: true
+    azure_api_version: "2024-02-15-preview"
+    model_list:
+      - model_name: gpt-4-azure
+        model_params:
+          model: gpt-4
+          context_limit: 128000
+```
+
+##### Full Example
+
+```yaml
+# User configuration - merged with built-in config
 main_model: opus
 
 sub_agent_models:
-  oracle: gpt-5.1
-  explore: haiku
+  oracle: gpt-4.1
+  explore: sonnet
   task: opus
-  webagent: haiku
+  webagent: sonnet
 
+provider_list:
+  # Add models to built-in openrouter
+  - provider_name: openrouter
+    model_list:
+      - model_name: qwen-coder
+        model_params:
+          model: qwen/qwen-2.5-coder-32b-instruct
+          context_limit: 131072
+
+  # Add a completely new provider
+  - provider_name: local-ollama
+    protocol: openai
+    base_url: http://localhost:11434/v1
+    api_key: ollama
+    model_list:
+      - model_name: local-llama
+        model_params:
+          model: llama3.2
+          context_limit: 8192
 ```
 
+##### Supported Protocols
+
+- `anthropic` - Anthropic Claude API
+- `openai` - OpenAI-compatible API
+- `responses` - OpenAI Responses API (for o-series, GPT-5, Codex)
+- `openrouter` - OpenRouter API
+- `codex` - OpenAI Codex CLI (OAuth-based)
+
 List configured providers and models:
 
 ```bash

{klaude_code-1.2.26 → klaude_code-1.2.28}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "uv_build"
 
 [project]
 name = "klaude-code"
-version = "1.2.26"
-description = "Add your description here"
+version = "1.2.28"
+description = "Minimal code agent CLI"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
@@ -27,6 +27,7 @@ dependencies = [
 
 [project.scripts]
 klaude = "klaude_code.cli.main:app"
+klaude-code = "klaude_code.cli.main:app"
 
 [tool.uv.build-backend]
 module-name = "klaude_code"

{klaude_code-1.2.26 → klaude_code-1.2.28}/src/klaude_code/cli/config_cmd.py

@@ -16,8 +16,6 @@ def list_models() -> None:
     from klaude_code.ui.terminal.color import is_light_terminal_background
 
     config = load_config()
-    if config is None:
-        raise typer.Exit(1)
 
     # Auto-detect theme when not explicitly set in config, to match other CLI entrypoints.
     if config.theme is None:
@@ -60,9 +58,7 @@ def edit_config() -> None:
             editor = "xdg-open"
 
     # Ensure config file exists
-    config = load_config()
-    if config is None:
-        raise typer.Exit(1)
+    load_config()
 
     try:
         if editor == "open -a TextEdit":

{klaude_code-1.2.26 → klaude_code-1.2.28}/src/klaude_code/cli/debug.py

@@ -63,7 +63,15 @@ def open_log_file_in_editor(path: Path) -> None:
             editor = "xdg-open"
 
     try:
-        subprocess.Popen([editor, str(path)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        # Detach stdin to prevent the editor from interfering with terminal input state.
+        # Without this, the spawned process inherits the parent's TTY and can disrupt
+        # prompt_toolkit's keyboard handling (e.g., history navigation with up/down keys).
+        subprocess.Popen(
+            [editor, str(path)],
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
     except FileNotFoundError:
         log((f"Error: Editor '{editor}' not found", "red"))
     except Exception as exc:  # pragma: no cover - best effort