oh-my-kimichan

Turn Kimi Code CLI into a worktree-based coding team
_{Multi-agent orchestration harness / DESIGN.md-aware UI / Live quality gates / AGENTS.md compatible}

Korean / English / Chinese / Japanese

Table of Contents

• GitHub Release Snapshot
• Repository Topics
• Korean
• English
• Chinese
• Japanese
• Customization
• Acknowledgements

GitHub Release Snapshot

Current GitHub-ready version: 0.2.2 — documented for the active open-source README branch.

GitHub Markdown checklist

• GitHub Actions / package version / npm / stars / forks / issues badges are visible at the top.
• Mermaid architecture diagrams render in GitHub-flavored Markdown.
• Repository topic badges below match the recommended GitHub topics.
• README logo PNG display width increased to 720px for a stronger GitHub landing page.

Repository Topics

These topics are also mirrored in package.json keywords for npm/GitHub discoverability.

Recommended GitHub topics:

kimi, kimi-cli, kimi-code, kimi-k2, ai-agent, coding-agent, multi-agent, agentic-coding, orchestration, dag, task-graph, ensemble, mcp, model-context-protocol, lsp, typescript, nodejs, cli, developer-tools, worktree

Korean

Kimi Code CLI를 worktree 기반 코딩 팀으로 변환하세요. DESIGN.md 기반 UI 생성, AGENTS.md 호환성, 실시간 품질 게이트를 제공합니다.

Features

Install

npm install -g oh-my-kimichan

Requirements: Node.js >= 20, Git, python3, Kimi CLI (v1.39.0+)

Quick Start

omk init
omk doctor
omk chat

Kimi-native context

oh-my-kimichan agents use an Okabe-compatible base agent that inherits default and adds SendDMail, so D-Mail is available for checkpoint rollback and context recovery. Use it before risky refactors, long-running handoffs, or /compact; durable facts still go to project-local ontology graph memory.

Project-local graph memory

OMK stores project/session memory in .omk/memory/graph-state.json by default, decomposes notes into ontology nodes (Goal, Decision, Task, Risk, Command, File, Evidence, Concept), and exposes omk_memory_mindmap plus omk_graph_query for GraphQL-lite access. External Neo4j remains optional.

The interactive wrapper also augments Kimi’s native context: status line with a masked OAuth account plus 5-hour and weekly usage/quota. See docs/kimi-oauth-usage-status.md.

Preview

$ omk doctor
OK Node.js           v22.14.0
OK Git               2.49.0
OK Python            3.13.2
OK tmux              3.5a
OK Kimi CLI          v1.39.0
OK Scaffold          .omk/, .kimi/skills/ found

$ omk team
Team Runtime starting...
   [architect]  Creating plan.md...
   [coder]      Implementation in progress...
   [reviewer]   Code review done
   [qa]         Tests passed

CLI Commands

Stable

Experimental

🏗️ 아키텍처

graph TD
    A[User / omk CLI] --> B[OMK Controller]
    B --> C[DAG Scheduler]
    B --> D[HUD / Trace Viewer]
    B --> E[Memory & Context Broker]
    B --> F[Safety / Approval Gateway]
    B --> G[Kimi Native Layer]
    G --> G1[Wire Mode JSON-RPC]
    G --> G2[Print Mode]
    G --> G3[Agents / Subagents]
    G --> G4[Skills / Flows]
    G --> G5[Hooks]
    G --> G6[MCP Servers]

🛡️ 안전

기본 훅은 파괴적 명령과 비밀 유출을 차단합니다:

• .omk/config.toml의 기본 approval policy는 오픈소스 자동화를 위해 yolo입니다.
• pre-shell-guard.sh — rm -rf /, sudo, git push --force 등 차단
• protect-secrets.sh — .env 편집 및 비밀 유출 차단
• post-format.sh — 수정된 파일 자동 포맷
• stop-verify.sh — 종료 시 최종 검증

🔌 내장 LSP

omk lsp --print-config
omk lsp --check
omk lsp typescript

omk init은 .omk/lsp.json을 생성하고, TypeScript/JavaScript 프로젝트에서 사용할 수 있는 번들 typescript-language-server 실행 경로를 제공합니다.

📄 라이선스

MIT

English

Turn Kimi Code CLI into a worktree-based coding team with DESIGN.md-aware UI generation, AGENTS.md compatibility, and live quality gates.

Features

Install

npm install -g oh-my-kimichan

Requirements: Node.js >= 20, Git, python3, Kimi CLI (v1.39.0+)

Quick Start

omk init
omk doctor
omk chat

Preview

$ omk doctor
OK Node.js           v22.14.0
OK Git               2.49.0
OK Python            3.13.2
OK tmux              3.5a
OK Kimi CLI          v1.39.0
OK Scaffold          .omk/, .kimi/skills/ found

$ omk team
Team Runtime starting...
   [architect]  Creating plan.md...
   [coder]      Implementation in progress...
   [reviewer]   Code review done
   [qa]         Tests passed

CLI Commands

Stable

Experimental

🏗️ Architecture

graph TD
    A[User / omk CLI] --> B[OMK Controller]
    B --> C[DAG Scheduler]
    B --> D[HUD / Trace Viewer]
    B --> E[Memory & Context Broker]
    B --> F[Safety / Approval Gateway]
    B --> G[Kimi Native Layer]
    G --> G1[Wire Mode JSON-RPC]
    G --> G2[Print Mode]
    G --> G3[Agents / Subagents]
    G --> G4[Skills / Flows]
    G --> G5[Hooks]
    G --> G6[MCP Servers]

🛡️ Safety

Default hooks block destructive commands and secret leakage:

• pre-shell-guard.sh — Blocks rm -rf /, sudo, git push --force, etc.
• protect-secrets.sh — Blocks .env edits and secret leakage
• post-format.sh — Auto-formats modified files
• stop-verify.sh — Final verification on stop

📄 License

MIT

Chinese

将 Kimi Code CLI 转变为一个基于 worktree 的编码团队。支持 DESIGN.md 感知 UI 生成、AGENTS.md 兼容性以及实时质量门禁。

Features

Install

npm install -g oh-my-kimichan

要求： Node.js >= 20、Git、python3、Kimi CLI (v1.39.0+)

Quick Start

omk init
omk doctor
omk chat

Preview

$ omk doctor
OK Node.js           v22.14.0
OK Git               2.49.0
OK Python            3.13.2
OK tmux              3.5a
OK Kimi CLI          v1.39.0
OK Scaffold          .omk/, .kimi/skills/ found

$ omk team
Team Runtime 启动中...
   [architect]  创建 plan.md...
   [coder]      实现进行中...
   [reviewer]   代码审查完成
   [qa]         测试通过

CLI Commands

Stable

Experimental

🏗️ 架构

graph TD
    A[User / omk CLI] --> B[OMK Controller]
    B --> C[DAG Scheduler]
    B --> D[HUD / Trace Viewer]
    B --> E[Memory & Context Broker]
    B --> F[Safety / Approval Gateway]
    B --> G[Kimi Native Layer]
    G --> G1[Wire Mode JSON-RPC]
    G --> G2[Print Mode]
    G --> G3[Agents / Subagents]
    G --> G4[Skills / Flows]
    G --> G5[Hooks]
    G --> G6[MCP Servers]

🛡️ 安全

默认钩子阻止破坏性命令和密钥泄漏：

• pre-shell-guard.sh — 阻止 rm -rf /、sudo、git push --force 等
• protect-secrets.sh — 阻止 .env 编辑及密钥泄漏
• post-format.sh — 自动格式化修改的文件
• stop-verify.sh — 停止时的最终验证

📄 许可证

MIT

Japanese

Kimi Code CLI を worktree ベースのコーディングチームに変換します。DESIGN.md 対応の UI 生成、AGENTS.md 互換性、ライブ品質ゲートを提供します。

Features

Install

npm install -g oh-my-kimichan

要件: Node.js >= 20、Git、python3、Kimi CLI (v1.39.0+)

Quick Start

omk init
omk doctor
omk chat

Preview

$ omk doctor
OK Node.js           v22.14.0
OK Git               2.49.0
OK Python            3.13.2
OK tmux              3.5a
OK Kimi CLI          v1.39.0
OK Scaffold          .omk/, .kimi/skills/ found

$ omk team
Team Runtime 開始中...
   [architect]  plan.md 作成中...
   [coder]      実装進行中...
   [reviewer]   コードレビュー完了
   [qa]         テスト通過

CLI Commands

Stable

Experimental

🏗️ アーキテクチャ

graph TD
    A[User / omk CLI] --> B[OMK Controller]
    B --> C[DAG Scheduler]
    B --> D[HUD / Trace Viewer]
    B --> E[Memory & Context Broker]
    B --> F[Safety / Approval Gateway]
    B --> G[Kimi Native Layer]
    G --> G1[Wire Mode JSON-RPC]
    G --> G2[Print Mode]
    G --> G3[Agents / Subagents]
    G --> G4[Skills / Flows]
    G --> G5[Hooks]
    G --> G6[MCP Servers]

🛡️ セーフティ

デフォルトのフックは破壊的コマンドとシークレットの漏洩をブロックします：

• pre-shell-guard.sh — rm -rf /、sudo、git push --force などをブロック
• protect-secrets.sh — .env の編集とシークレットの漏洩をブロック
• post-format.sh — 変更ファイルの自動フォーマット
• stop-verify.sh — 停止時の最終検証

📄 ライセンス

MIT

Customization

🎨 Custom Welcome Banner Image

You can override Kimi CLI's default ASCII banner with your own image:

1. Place your image in the project root (e.g. kimichan.png).
2. Add to .omk/config.toml:

[theme]
logo_image = "kimichan.png"

• Supports PNG, JPEG, and GIF.
• Relative paths are resolved from the project root; absolute paths (including Windows C:\... or M:\...) work too.
• In iTerm, Kitty, WezTerm, and other graphics-capable terminals, the image renders in full resolution.
• In standard terminals, it falls back to high-quality ANSI block art via terminal-image.
• If the image is missing or rendering fails, the built-in ASCII art is used automatically.

Acknowledgements

This project is built on top of amazing open-source work:

• Kimi Code CLI by Moonshot AI - The foundation that makes everything possible
• Google DESIGN.md - Design specification standard for UI generation
• Commander.js - Elegant command-line interfaces
• Zod - TypeScript-first schema validation
• tmux - Terminal multiplexer for team runtime