Add Kimi Code CLI as a compile/install target

[gudzenkov]

Feature request

Add Kimi Code CLI (Moonshot AI's agentic coding CLI, kimi) as a supported target for apm compile / apm install, alongside the existing claude, codex, cursor, gemini, copilot, opencode, windsurf, and kiro targets.

Motivation

Kimi Code is a growing agent runtime with an open, file-based configuration model that maps very cleanly onto APM's primitives (instructions, agents, skills). Teams running multi-runtime setups currently have to hand-deploy APM packages to Kimi, which defeats the single-source-of-truth workflow APM provides for other runtimes.

Proposed target mapping

Kimi Code's discovery paths (from the official docs):

APM primitive	Kimi Code destination (user/global)	Project level
Instructions (AGENTS.md)	~/.kimi-code/AGENTS.md (moves with KIMI_CODE_HOME)	project AGENTS.md / .kimi-code/AGENTS.md
Skills	~/.kimi-code/skills/	.kimi-code/skills/
Agents (sub-agent profiles)	~/.kimi-code/agents/	.kimi-code/agents/

Notes that make this low-effort:

• Shared cross-client paths already exist: Kimi also reads ~/.agents/skills/ and ~/.agents/agents/ — the same shared ~/.agents/ convention APM already uses for the codex skills deploy, so skills may need no new deploy logic at all.
• Agent file format is markdown + YAML frontmatter (name, description, tools, whenToUse, ...), and Kimi explicitly tolerates Claude Code-style agent files (comma-separated tools, unknown fields ignored, filename fallback for name). So existing .agent.md sources likely compile to Kimi profiles with little or no transformation.
• Target detection marker: presence of a .kimi-code/ directory (consistent with how cursor/windsurf/kiro targets are detected).

References

• Agents/sub-agents: https://www.kimi.com/code/docs/en/kimi-code-cli/customization/agents.html
• Skills: https://www.kimi.com/code/docs/en/kimi-code-cli/customization/skills.html
• Configuration (KIMI_CODE_HOME, extra_agent_dirs, extra_skill_dirs): https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/config-files.html

[github-actions]

Triage Panel Verdict

Decision: ACCEPT

Synthesis

The DevX UX expert finds this well-specified: the path mapping table is concrete, the detection marker (.kimi-code/) is clear, and the agent file format compatibility with Claude Code-style markdown+YAML frontmatter means the compile transform requires minimal new logic. The OSS Growth Hacker notes Kimi Code is a fast-growing Moonshot AI runtime with strong adoption in Asia-Pacific markets -- adding it expands APM's credibility as a true multi-runtime standard and makes the "single source of truth" pitch more compelling to teams running heterogeneous agent stacks. The Supply Chain Security expert sees no novel attack surface: path resolution follows the same user-home convention already used for codex/~/.agents/, no credential or token handling is introduced, and the shared ~/.agents/skills/ overlap actually reduces implementation divergence. The APM CEO rules ACCEPT: the scope is bounded (one new integrator module, a detection heuristic, and path constants), the proposed mapping is sufficiently detailed to implement without a design brief, and the ~/.agents/ overlap observation may allow skills deploy to reuse existing codex logic with zero duplication cost.

Dimensions

Dimension	Value
Type	type/feature
Area	area/cli, area/multi-target
Priority	priority/low
Theme	theme/portability
Milestone	TBD

Labels to apply

type/feature area/cli area/multi-target theme/portability priority/low status/accepted status/triaged

Suggested next action

Implement a KimiIntegrator following the BaseIntegrator pattern, reusing codex skills-deploy logic for the ~/.agents/ shared path, and wiring the .kimi-code/ directory as the detection marker. No design brief required -- the issue body is sufficient spec.

Generated by Triage Panel · 148.5 AIC · ⌖ 7 AIC · ⊞ 9.2K · ◷

[github-actions]

Triage Panel Verdict

Decision: ACCEPT

Synthesis

This is a well-scoped feature request with a concrete, verified target mapping. The reporter has done the integration research: Kimi Code's discovery paths are documented, the agent file format is compatible with existing .agent.md sources (YAML frontmatter, Claude Code-style fields tolerated, unknown fields ignored), and the shared ~/.agents/ path convention Kimi already supports overlaps with the codex skills-deploy path APM uses today -- suggesting skills may require no new deploy logic. Target detection via .kimi-code/ directory presence is consistent with how cursor, windsurf, and kiro targets are detected. The OSS growth angle is real: Kimi Code is a growing agentic coding CLI with significant adoption in multi-runtime teams; adding it reduces the friction for those teams who currently hand-deploy APM packages. From a security standpoint, the integration follows the same file-based pattern as existing targets and introduces no new trust surface beyond what is already present for codex. The implementation scope is bounded to one new integrator class and a compile-target registration. No design brief needed.

Dimensions

Dimension	Value
Type	type/feature
Area	area/cli, area/multi-target
Priority	none
Theme	none
Milestone	TBD

Labels to apply

type/feature area/cli area/multi-target status/triaged

Suggested next action

Implement a KimiIntegrator following the existing BaseIntegrator pattern, mapping instructions to ~/.kimi-code/AGENTS.md / .kimi-code/AGENTS.md, skills to ~/.kimi-code/skills/, and agents to ~/.kimi-code/agents/; register kimi as a canonical target in the compile and install commands; add target detection on .kimi-code/ directory presence.

---

Triage status: agentic proposal pending human ratification.
Silence is approval. Maintainers can:

• Override any label or milestone above by editing it directly --
  human edits are authoritative and will not be reverted on
  subsequent runs.
• Re-trigger triage by applying the status/needs-triage label, or
  by removing status/triaged to enroll the issue in the next
  daily sweep.

Posted by the Triage Panel workflow. See .apm/skills/apm-triage-panel for the panel skill.

Generated by Triage Panel · 148.5 AIC · ⌖ 7 AIC · ⊞ 9.2K · ◷