Skip to content

README.md

Latest commit

 

History

History
102 lines (73 loc) · 4.63 KB

README.md

File metadata and controls

102 lines (73 loc) · 4.63 KB
Raw

Kimi-Code-Swarm

Local Agent Command Center for Kimi CLI

Dispatch tasks, monitor progress, review PRs — direct N Kimi CLI workers from one desktop UI.

One Kimi account → N isolated workspaces → N concurrent CLI workers → each submits a PR → you review and merge.

Release License Platform Stars

⬇ Download v0.1.0 · 📖 Docs · 🐛 Backlog · 简体中文

⚠️ Not a commercial product — this is a proving ground for Harness Engineering methodology. The core value isn't the features themselves; it's the loop of practice → discover problems → abstract definitions → solve problems.

How It Works

Commander (You)
    │
    ▼
┌─────────────────────────────┐
│  Kimi-Code-Swarm App        │
│  ├── New Task (auto clone)  │
│  ├── Enter Instructions     │
│  ├── Real-time Monitoring   │
│  └── Review PR → Merge      │
└─────────────────────────────┘
    │
    ├─► Agent-01 @ ~/workspace/agent-01  ──► PR #42
    ├─► Agent-02 @ ~/workspace/agent-02  ──► PR #43
    └─► Agent-03 @ ~/workspace/agent-03  ──► PR #44

Core Features

  • 🎯 Task Dispatch — Click "New Task"; the App auto-clones the repo, switches branches, and launches the CLI
  • 📝 Instruction Interaction — Natural-language multi-turn dialogue with each Agent
  • 🤖 Auto Submit & Review — Agent runs git commit/push and opens a PR on completion; auto-fixes pre-commit failures (up to 3 rounds)
  • 🔍 PR Review — View diffs, merge or reject in-app; all-hands review gate (all other Agents must pass)
  • 📊 Real-time Monitoring — Token consumption, Git branches, PR status, process liveness

🪟 Windows-first. Rust process management contains Windows-only logic; macOS/Linux requires adaptation. Browser dev mode is unaffected.

🚀 Quick Start

Option A — Install pre-built (recommended)

Download the installer from Releases:

Platform Installer Notes
Windows kimi-code-swarm_*_x64-setup.exe (NSIS) ~10 MB, recommended
Windows kimi-code-swarm_*_x64_en-US.msi ~15 MB, for enterprise GPO

First run may trigger Windows SmartScreen (binaries are unsigned). Click More info → Run anyway.

Option B — Build from source

git clone https://github.com/HelloWorldU/Kimi-Code-Swarm.git
cd Kimi-Code-Swarm/kimi-code-swarm
npm install          # auto-configures Git hooks
npm run dev          # browser mode, localhost:5173
npm run tauri dev    # desktop mode (requires Rust)

Prerequisites

Tool Purpose Install
Kimi CLI Agent execution engine py -3.12 -m pip install kimi-cli
Kimi API Key App login + CLI injection https://www.kimi.com/code/console
Node.js 22+ Frontend + Agent Engine https://nodejs.org/
Git Agent clone/commit/push https://git-scm.com/
GitHub Token (optional) Real PR ops (else Mock) GitHub Settings → PAT
Rust (source build only) Tauri desktop shell https://rustup.rs/

First time use: Open the App → Enter Kimi API Key → Verify → Create Agent → Enter repo URL and instructions → Launch.

Core features (real CLI invocation, Git automation) only work in Tauri desktop mode.

Documentation

License

MIT