Merge pull request #251 from tonyblu331/feat-kimi

feat: kimi support

Author: Alan-TheGentleman

docs/agents.md

@@ -6,29 +6,30 @@
 
 ## Agent Matrix
 
-| Agent | ID | Skills | MCP | Delegation | Output Styles | Slash Commands | Config Path |
-|-------|-----|--------|-----|------------|---------------|----------------|-------------|
-| Claude Code | `claude-code` | Yes | Yes | Full (Task tool) | Yes | No | `~/.claude` |
-| OpenCode | `opencode` | Yes | Yes | Full (multi-mode overlay) | No | Yes | `~/.config/opencode` |
-| Gemini CLI | `gemini-cli` | Yes | Yes | Full (experimental) | No | No | `~/.gemini` |
-| Cursor | `cursor` | Yes | Yes | Full (native subagents) | No | No | `~/.cursor` |
-| VS Code Copilot | `vscode-copilot` | Yes | Yes | Full (runSubagent) | No | No | `~/.copilot` + VS Code User profile |
-| Codex | `codex` | Yes | Yes | Solo-agent | No | No | `~/.codex` |
-| Windsurf | `windsurf` | Yes (native) | Yes | Solo-agent | No | No | `~/.codeium/windsurf` |
-| Antigravity | `antigravity` | Yes (native) | Yes | Solo-agent + Mission Control | No | No | `~/.gemini/antigravity` |
-| Kiro IDE | `kiro-ide` | Yes | Yes | Full (native subagents) | No | No | `~/.kiro` |
-| Qwen Code | `qwen-code` | Yes | Yes | Full (native sub-agents) | No | Yes | `~/.qwen` |
+| Agent           | ID               | Skills       | MCP | Delegation                   | Output Styles | Slash Commands | Config Path                         |
+| --------------- | ---------------- | ------------ | --- | ---------------------------- | ------------- | -------------- | ----------------------------------- |
+| Claude Code     | `claude-code`    | Yes          | Yes | Full (Task tool)             | Yes           | No             | `~/.claude`                         |
+| OpenCode        | `opencode`       | Yes          | Yes | Full (multi-mode overlay)    | No            | Yes            | `~/.config/opencode`                |
+| Gemini CLI      | `gemini-cli`     | Yes          | Yes | Full (experimental)          | No            | No             | `~/.gemini`                         |
+| Cursor          | `cursor`         | Yes          | Yes | Full (native subagents)      | No            | No             | `~/.cursor`                         |
+| VS Code Copilot | `vscode-copilot` | Yes          | Yes | Full (runSubagent)           | No            | No             | `~/.copilot` + VS Code User profile |
+| Codex           | `codex`          | Yes          | Yes | Solo-agent                   | No            | No             | `~/.codex`                          |
+| Windsurf        | `windsurf`       | Yes (native) | Yes | Solo-agent                   | No            | No             | `~/.codeium/windsurf`               |
+| Antigravity     | `antigravity`    | Yes (native) | Yes | Solo-agent + Mission Control | No            | No             | `~/.gemini/antigravity`             |
+| Kimi            | `kimi`           | Yes          | Yes | Full (native custom agents)  | No            | No             | `~/.kimi`                           |
+| Qwen Code       | `qwen-code`      | Yes          | Yes | Full (native sub-agents)     | No            | Yes            | `~/.qwen`                           |
+| Kiro IDE        | `kiro-ide`       | Yes          | Yes | Full (native subagents)      | No            | No             | `~/.kiro`                           |
 
 All agents receive the **full SDD orchestrator** injected into their system prompt, plus skill files written to their skills directory. The agent handles SDD automatically when the task is large enough, or when the user explicitly asks for it — no manual setup required.
 
 ---
 
 ## Delegation Models
 
-| Model | How It Works | Agents |
-|-------|-------------|--------|
-| **Full (sub-agents)** | Each SDD phase runs in an isolated context window via native sub-agent delegation. The orchestrator coordinates; sub-agents execute. | Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot, Qwen Code |
-| **Solo-agent** | All SDD phases run inline in the same conversation. The orchestrator IS the executor. Engram provides cross-phase persistence. | Codex, Windsurf, Antigravity |
+| Model                 | How It Works                                                                                                                         | Agents                                                           |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
+| **Full (sub-agents)** | Each SDD phase runs in an isolated context window via native sub-agent delegation. The orchestrator coordinates; sub-agents execute. | Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot, Kimi, Kiro IDE, Qwen Code |
+| **Solo-agent**        | All SDD phases run inline in the same conversation. The orchestrator IS the executor. Engram provides cross-phase persistence.       | Codex, Windsurf, Antigravity                                     |
 
 ### Cursor Native Subagents
 
@@ -78,18 +79,21 @@ Kiro uses native custom agents in `~/.kiro/agents/`. `gentle-ai` writes 10 phase
 ## Agent Notes
 
 ### Claude Code
+
 - Sub-agents via the native Task tool with isolated context windows
 - MCP servers configured as plugins in `~/.claude/mcp/`
 - Output styles in `~/.claude/output-styles/`
 - System prompt via markdown sections in `~/.claude/CLAUDE.md`
 
 ### OpenCode
+
 - Full multi-agent overlay with 12 named agents in `opencode.json`
 - Slash commands for SDD phases (`/sdd-new`, `/sdd-explore`, etc.)
 - Background-agents plugin for parallel execution
 - Multi-mode prerequisite: connect your AI providers first, then run `opencode models --refresh`
 
 ### Gemini CLI
+
 - Sub-agents are experimental: require `experimental.enableAgents: true` in `settings.json`
 - Custom sub-agents defined as markdown files in `~/.gemini/agents/`
 
@@ -100,31 +104,44 @@ Kiro uses native custom agents in `~/.kiro/agents/`. `gentle-ai` writes 10 phase
 - MCP config in `~/.cursor/mcp.json`
 
 ### VS Code Copilot
+
 - Uses the `runSubagent` tool with support for parallel execution
 - Skills at `~/.copilot/skills/`
 - System prompt at `Code/User/prompts/gentle-ai.instructions.md`
 - MCP config at `Code/User/mcp.json`
 
 ### Codex
+
 - CLI-native agent with TOML config at `~/.codex/config.toml`
 - Skills at `~/.codex/skills/`
 - System prompt at `~/.codex/agents.md`
 - Engram instruction files at `~/.codex/engram-instructions.md`
 
 ### Windsurf
+
 - Skills at `~/.codeium/windsurf/skills/` (native Windsurf feature)
 - MCP config at `~/.codeium/windsurf/mcp_config.json`
 - Global rules at `~/.codeium/windsurf/memories/global_rules.md`
 - Workflows at `.windsurf/workflows/` (workspace-scoped)
 
 ### Antigravity
+
 - Skills at `~/.gemini/antigravity/skills/` (native Antigravity feature)
 - MCP config at `~/.gemini/antigravity/mcp_config.json`
 - System prompt appended to `~/.gemini/GEMINI.md` (shared with Gemini CLI — collision check warns if both are installed)
 - Mission Control handles built-in sub-agent delegation (Browser, Terminal) automatically
 - Settings managed via the IDE's Agent settings UI, not via `settings.json`
 
+### Kimi
+
+- Installation requires the `uv` Python package manager (`uv tool install kimi-cli`).
+- Root custom agent at `~/.kimi/agents/gentleman.yaml` with `system_prompt_path: ../KIMI.md`
+- `KIMI.md` is a thin Jinja template that includes modular prompt files:
+  `persona.md`, `output-style.md`, `engram-protocol.md`, `sdd-orchestrator.md`
+- Built-in Kimi variables are preserved in `KIMI.md`: `${KIMI_AGENTS_MD}` and `${KIMI_SKILLS}`
+
 ### Kiro IDE
+
 - **Detection**: gentle-ai detects Kiro from its config root (`~/.kiro`) during install/TUI discovery — `~/.kiro` must exist (created on first Kiro launch). `kiro` on `PATH` is also checked for sync/upgrade flows but is not required for install auto-detection
 - **Steering file** (all platforms): `~/.kiro/steering/gentle-ai.md` with frontmatter `inclusion: always`
 - Native subagents at `~/.kiro/agents/sdd-{phase}.md` (10 files)

docs/platforms.md

@@ -58,5 +58,6 @@ If the hash matches `checksums.txt`, the file is authentic for that release.
 | VS Code Copilot | `%APPDATA%\Code\User\` (settings, MCP, prompts) + `%USERPROFILE%\.copilot\` (skills) |
 | Codex | `%USERPROFILE%\.codex\` |
 | Windsurf | `%USERPROFILE%\.codeium\windsurf\` (skills, MCP, rules) + `%APPDATA%\Windsurf\User\` (settings) |
+| Kimi | `%USERPROFILE%\.kimi\` (includes `config.toml`, system prompt, agents, MCP) |
 | Antigravity | `%USERPROFILE%\.gemini\antigravity\` |
 | Kiro IDE | `%USERPROFILE%\.kiro\steering\` (prompts) + `%USERPROFILE%\.kiro\skills\` (skills) + `%USERPROFILE%\.kiro\agents\` (SDD agents) + `%APPDATA%\kiro\User\settings.json` (settings) + `%USERPROFILE%\.kiro\settings\mcp.json` (MCP) |

internal/agents/factory.go

@@ -9,6 +9,7 @@ import (
 	cursoradapter "github.com/gentleman-programming/gentle-ai/internal/agents/cursor"
 	"github.com/gentleman-programming/gentle-ai/internal/agents/gemini"
 	"github.com/gentleman-programming/gentle-ai/internal/agents/kilocode"
+	"github.com/gentleman-programming/gentle-ai/internal/agents/kimi"
 	"github.com/gentleman-programming/gentle-ai/internal/agents/kiro"
 	"github.com/gentleman-programming/gentle-ai/internal/agents/opencode"
 	"github.com/gentleman-programming/gentle-ai/internal/agents/qwen"
@@ -37,6 +38,8 @@ func NewAdapter(agent model.AgentID) (Adapter, error) {
 		return antigravity.NewAdapter(), nil
 	case model.AgentWindsurf:
 		return windsurf.NewAdapter(), nil
+	case model.AgentKimi:
+		return kimi.NewAdapter(), nil
 	case model.AgentQwenCode:
 		return qwen.NewAdapter(), nil
 	case model.AgentKiroIDE:
@@ -47,7 +50,7 @@ func NewAdapter(agent model.AgentID) (Adapter, error) {
 }
 
 func NewDefaultRegistry() (*Registry, error) {
-	adapters := make([]Adapter, 0, 9)
+	adapters := make([]Adapter, 0, 12)
 
 	for _, agent := range []model.AgentID{
 		model.AgentClaudeCode,
@@ -59,6 +62,7 @@ func NewDefaultRegistry() (*Registry, error) {
 		model.AgentCodex,
 		model.AgentAntigravity,
 		model.AgentWindsurf,
+		model.AgentKimi,
 		model.AgentQwenCode,
 		model.AgentKiroIDE,
 	} {