feat: add first-class Kimi provider (#824)

* feat: add first-class Kimi provider

* test: parameterize provider environment coverage

Author: Real5K

.env.example

@@ -16,6 +16,10 @@ OPENAI_API_KEY=your_openai_api_key_here
 DEEPSEEK_API_KEY=your_deepseek_api_key_here
 # DEEPSEEK_BASE_URL=https://api.deepseek.com
 
+# Kimi
+KIMI_API_KEY=your_kimi_api_key_here
+# KIMI_BASE_URL=https://api.kimi.com/coding/v1
+
 # Ollama — no API key needed, but set base URL if non-default
 # OLLAMA_BASE_URL=http://localhost:11434
 

docs/CLI_REFERENCE.md

@@ -62,7 +62,7 @@ All three reach the indexing knobs; the LLM-only knobs appear only when docs are
 
 | Flag | Description |
 |------|-------------|
-| `--provider` | LLM provider: `anthropic`, `openai`, `openrouter`, `gemini`, `deepseek`, `ollama`, `litellm`, `codex_cli`, `opencode`, `mock` |
+| `--provider` | LLM provider: `anthropic`, `openai`, `openrouter`, `gemini`, `deepseek`, `kimi`, `ollama`, `litellm`, `codex_cli`, `opencode`, `mock` |
 | `--model` | Model name override (e.g., `claude-sonnet-4-6`) |
 | `--embedder` | Embedder for semantic search: `gemini`, `openai`, `openrouter`, `ollama`, `mock` (default: auto-detect) |
 | `--index-only` | Skip LLM generation. Only parse, build graph, and index git. Free. |

docs/CONFIG.md

@@ -68,7 +68,7 @@ You can edit this file directly. Changes take effect on the next `init`,
 
 | Key | Default | Meaning |
 |-----|---------|---------|
-| `provider` | auto-detected | `anthropic`, `openai`, `gemini`, `openrouter`, `deepseek`, `ollama`, `litellm`, `opencode` |
+| `provider` | auto-detected | `anthropic`, `openai`, `gemini`, `openrouter`, `deepseek`, `kimi`, `ollama`, `litellm`, `opencode` |
 | `model` | provider default | Model identifier passed to the provider |
 | `embedder` | `mock` | `openai`, `gemini`, `ollama`, `openrouter`, `mock` |
 | `embedding_model` | provider default | Embedding model identifier |
@@ -345,6 +345,29 @@ export DEEPSEEK_API_KEY="..."
 repowise init --provider deepseek --model deepseek-chat
 ```
 
+### Kimi
+
+```bash
+export KIMI_API_KEY="..."
+repowise init --provider kimi --model kimi-for-coding
+```
+
+The default Kimi Code endpoint supports `kimi-for-coding` and
+`kimi-for-coding-highspeed`. Repowise automatically uses their required
+sampling parameters.
+
+K2.x models use the separate Kimi Open Platform. Supply a key from that
+platform together with its OpenAI-compatible endpoint:
+
+```bash
+export KIMI_API_KEY="..."
+export KIMI_BASE_URL="https://api.moonshot.ai/v1"
+repowise init --provider kimi --model kimi-k2.6
+```
+
+For K2.x models, Repowise selects the required sampling parameters for
+thinking or instant mode.
+
 ### Ollama (local, no API key)
 
 ```bash
@@ -367,7 +390,7 @@ order:
 
 1. `REPOWISE_PROVIDER` environment variable
 2. `provider` in `.repowise/config.yaml`
-3. API key env vars: `ANTHROPIC_API_KEY` → `OPENAI_API_KEY` → `OLLAMA_BASE_URL` → `GEMINI_API_KEY`
+3. API key env vars: `ANTHROPIC_API_KEY` → `OPENAI_API_KEY` → `OPENROUTER_API_KEY` → `OLLAMA_BASE_URL` → `GEMINI_API_KEY` → `DEEPSEEK_API_KEY` → `KIMI_API_KEY`
 
 ---
 
@@ -418,6 +441,7 @@ The `.repowise/.env` file is gitignored automatically.
 | `GEMINI_API_KEY` / `GOOGLE_API_KEY` | Google Gemini API key |
 | `OPENROUTER_API_KEY` | OpenRouter API key |
 | `DEEPSEEK_API_KEY` | DeepSeek API key |
+| `KIMI_API_KEY` | Kimi API key |
 | `LITELLM_API_KEY` | LiteLLM proxy key |
 | `LITELLM_API_BASE` | LiteLLM proxy base URL |
 
@@ -430,6 +454,7 @@ The `.repowise/.env` file is gitignored automatically.
 | `GEMINI_BASE_URL` | Override the Gemini API base URL |
 | `OLLAMA_BASE_URL` | Ollama server URL (default: `http://localhost:11434`) |
 | `DEEPSEEK_BASE_URL` | Override the DeepSeek API base URL |
+| `KIMI_BASE_URL` | Override the Kimi API base URL |
 | `LITELLM_BASE_URL` | Override the LiteLLM proxy base URL |
 
 ### Provider and model overrides

docs/USER_GUIDE.md

@@ -179,7 +179,7 @@ repowise init [PATH]
 
 | Flag | Description |
 |------|-------------|
-| `--provider` | LLM provider: `anthropic`, `openai`, `openrouter`, `gemini`, `deepseek`, `ollama`, `litellm`, `codex_cli`, `mock`. Auto-detected from env vars if not set. |
+| `--provider` | LLM provider: `anthropic`, `openai`, `openrouter`, `gemini`, `deepseek`, `kimi`, `ollama`, `litellm`, `codex_cli`, `mock`. Auto-detected from env vars if not set. |
 | `--model` | Model name override (e.g., `claude-sonnet-4-6`, `gpt-5.4-nano`) |
 | `--embedder` | Embedder for semantic search: `gemini`, `openai`, `mock`. Auto-detected from env vars. |
 | `--index-only` | Skip LLM generation entirely. Only parse, build graph, and index git. Free. |

docs/architecture/ARCHITECTURE.md

@@ -1615,7 +1615,7 @@ Key files:
 Full configuration with defaults (`.repowise/config.yaml`):
 
 ```yaml
-provider: anthropic          # anthropic | openai | openrouter | gemini | deepseek | ollama | litellm | codex_cli | opencode | mock
+provider: anthropic          # anthropic | openai | openrouter | gemini | deepseek | kimi | ollama | litellm | codex_cli | opencode | mock
 model: claude-sonnet-4-5    # passed through to the provider
 embedding_provider: anthropic
 embedding_model: voyage-3

packages/cli/src/repowise/cli/commands/init_cmd/command.py

@@ -108,7 +108,9 @@ def _record_init_outcome(
             "symbol_count_bucket": telemetry.bucket_count(getattr(result, "symbol_count", 0) or 0),
         }
 
-        lang_dist = getattr(getattr(result, "repo_structure", None), "root_language_distribution", None)
+        lang_dist = getattr(
+            getattr(result, "repo_structure", None), "root_language_distribution", None
+        )
         if isinstance(lang_dist, dict) and lang_dist:
             outcome["top_language"] = max(lang_dist.items(), key=lambda kv: kv[1])[0]
 
@@ -275,7 +277,7 @@ def _run_generation_phase(
     default=None,
     help=(
         "LLM provider name (anthropic, openai, openrouter, gemini, "
-        "deepseek, ollama, litellm, codex_cli, opencode, mock)."
+        "deepseek, kimi, ollama, litellm, codex_cli, opencode, mock)."
     ),
 )
 @click.option("--model", default=None, help="Model identifier override.")

packages/cli/src/repowise/cli/commands/workspace_cmd.py

@@ -379,6 +379,7 @@ def _resolve_docs_flag(
         "GEMINI_API_KEY",
         "GOOGLE_API_KEY",
         "DEEPSEEK_API_KEY",
+        "KIMI_API_KEY",
         "OLLAMA_BASE_URL",
     ):
         if _os.environ.get(key):

packages/cli/src/repowise/cli/helpers.py

@@ -610,6 +610,7 @@ def _resolve_base_url(name: str) -> str | None:
             "openai": ["OPENAI_BASE_URL"],
             "gemini": ["GEMINI_BASE_URL"],
             "deepseek": ["DEEPSEEK_BASE_URL"],
+            "kimi": ["KIMI_BASE_URL"],
             "ollama": ["OLLAMA_BASE_URL"],
             "litellm": ["LITELLM_BASE_URL", "LITELLM_API_BASE"],
         }
@@ -657,6 +658,8 @@ def _resolve_base_url(name: str) -> str | None:
             kwargs["api_key"] = os.environ["OPENROUTER_API_KEY"]
         elif provider_name == "deepseek" and os.environ.get("DEEPSEEK_API_KEY"):
             kwargs["api_key"] = os.environ["DEEPSEEK_API_KEY"]
+        elif provider_name == "kimi" and os.environ.get("KIMI_API_KEY"):
+            kwargs["api_key"] = os.environ["KIMI_API_KEY"]
         elif provider_name == "litellm" and os.environ.get("LITELLM_API_KEY"):
             kwargs["api_key"] = os.environ["LITELLM_API_KEY"]
         elif provider_name == "ollama" and os.environ.get("OLLAMA_BASE_URL"):
@@ -718,13 +721,24 @@ def _resolve_base_url(name: str) -> str | None:
         if base_url:
             kwargs["base_url"] = base_url
         return get_provider("deepseek", **kwargs)
+    if os.environ.get("KIMI_API_KEY") and os.environ["KIMI_API_KEY"].strip():
+        kwargs = (
+            {"model": model, "api_key": os.environ["KIMI_API_KEY"]}
+            if model
+            else {"api_key": os.environ["KIMI_API_KEY"]}
+        )
+        base_url = _resolve_base_url("kimi")
+        if base_url:
+            kwargs["base_url"] = base_url
+        return get_provider("kimi", **kwargs)
 
     raise click.ClickException(
         "No provider configured. Use --provider, set REPOWISE_PROVIDER, "
         "or set ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY / "
         "OLLAMA_BASE_URL / GEMINI_API_KEY / GOOGLE_API_KEY / DEEPSEEK_API_KEY / "
-        "LITELLM_API_KEY. Use REPOWISE_PROVIDER=codex_cli to use an authenticated "
-        "Codex CLI subscription, or REPOWISE_PROVIDER=opencode to use opencode."
+        "KIMI_API_KEY / LITELLM_API_KEY. Use REPOWISE_PROVIDER=codex_cli to use "
+        "an authenticated Codex CLI subscription, or REPOWISE_PROVIDER=opencode "
+        "to use opencode."
     )
 
 
@@ -760,6 +774,7 @@ def _is_env_var_exists(var_name: str) -> bool:
         "openai": ["OPENAI_API_KEY"],
         "openrouter": ["OPENROUTER_API_KEY"],
         "deepseek": ["DEEPSEEK_API_KEY"],
+        "kimi": ["KIMI_API_KEY"],
         "gemini": ["GEMINI_API_KEY", "GOOGLE_API_KEY"],  # Either one
         "ollama": ["OLLAMA_BASE_URL"],
         "litellm": ["LITELLM_API_KEY"],  # May need others depending on backend

packages/cli/src/repowise/cli/ui/provider_selection.py

@@ -25,6 +25,7 @@
     "openai": "gpt-5.4-nano",
     "anthropic": "claude-sonnet-4-6",
     "deepseek": "deepseek-v4-flash",
+    "kimi": "kimi-for-coding",
     "codex_cli": "codex_cli/default",
     "opencode": "opencode/default",
     "ollama": "llama3.2",
@@ -37,6 +38,7 @@
     "openai": "OPENAI_API_KEY",
     "anthropic": "ANTHROPIC_API_KEY",
     "deepseek": "DEEPSEEK_API_KEY",
+    "kimi": "KIMI_API_KEY",
     "codex_cli": "__CODEX_CLI__",
     "opencode": "__OPENCODE_CLI__",
     "ollama": "OLLAMA_BASE_URL",
@@ -48,6 +50,7 @@
     "openai": "https://platform.openai.com/api-keys",
     "anthropic": "https://console.anthropic.com/settings/keys",
     "deepseek": "https://platform.deepseek.com/api_keys",
+    "kimi": "https://www.kimi.com/code/console",
     "codex_cli": "https://developers.openai.com/codex/cli",
     "opencode": "https://opencode.ai",
     "ollama": "https://ollama.com/download",

packages/core/src/repowise/core/analysis/health/refactoring/llm/enrich.py

@@ -167,6 +167,7 @@ def _env(name: str) -> str | None:
         "openai": "OPENAI_API_KEY",
         "openrouter": "OPENROUTER_API_KEY",
         "deepseek": "DEEPSEEK_API_KEY",
+        "kimi": "KIMI_API_KEY",
         "gemini": "GEMINI_API_KEY",
         "litellm": "LITELLM_API_KEY",
     }