gsd-kimi-cli

GSD for Kimi CLI

Get Shit Done - A spec-driven development workflow system for Kimi CLI

🎯 What is GSD?

GSD (Get Shit Done) is a context engineering and spec-driven development workflow that makes AI assistants reliable for building software. It solves "context rot" — the quality degradation that happens as AI fills its context window.

Key Features:

• 📋 Structured Planning - Organize work into phases with clear objectives
• 🤖 Multi-Agent System - 11 specialized subagents for different tasks
• 🌊 Wave-Based Execution - Run independent plans in parallel
• ✅ Verification Built-in - User acceptance testing with gap detection
• 📝 Complete Documentation - PROJECT.md, REQUIREMENTS.md, ROADMAP.md
• 🔄 State Persistence - Resume work seamlessly after interruptions

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/optivent/gsd-kimi-cli.git
cd gsd-kimi-cli

# Run the installer
node scripts/install.js

# Apply Kimi CLI patches (optional but recommended)
jim --patch

# Start using GSD
jim

Usage

# Create a new project
/skill:gsd-new-project

# Plan a phase
/skill:gsd-plan-phase 1

# Execute the phase
/skill:gsd-execute-phase 1

# Verify the work
/skill:gsd-verify-work 1

# Check progress
/skill:gsd-progress

📦 What's Included

27 GSD Skills

11 GSD Agents

• gsd-executor - Executes plans atomically
• gsd-planner - Creates detailed phase plans
• gsd-verifier - Validates work against requirements
• gsd-debugger - Root cause analysis
• gsd-roadmapper - Creates project roadmaps
• gsd-phase-researcher - Researches phase implementation
• gsd-project-researcher - Researches project domain
• gsd-research-synthesizer - Combines research outputs
• gsd-codebase-mapper - Analyzes existing codebases
• gsd-plan-checker - Validates plans before execution
• gsd-integration-checker - Checks cross-phase wiring

9 Reference Knowledge Bases

• questioning.md - How to gather requirements
• planning-config.md - Planning configuration
• verification-patterns.md - Verification approaches
• git-integration.md - Git workflow best practices
• model-profiles.md - Model-specific settings
• tdd.md - Test-driven development
• ui-brand.md - UI/UX guidelines
• checkpoints.md - Checkpoint system
• continuation-format.md - Handoff format

Source Code Patching

For full UI integration, GSD patches Kimi CLI's source code:

• Status Bar - Shows GSD context (phase, todos, milestone)
• Welcome Message - GSD project awareness
• Context Provider - Real-time GSD state

🛠️ Installation Options

Option 1: Full Installation (Recommended)

node scripts/install.js
jim --patch

Includes:

• ✅ All 27 skills
• ✅ All 11 agents
• ✅ All 9 references
• ✅ All workflows
• ✅ UI patches

Option 2: Skills Only

node scripts/install.js --skills-only

Installs skills without patching Kimi CLI source.

Option 3: Manual Installation

# Copy skills to Kimi CLI skills directory
cp -r skills/* ~/.kimi/skills/

# Copy agents
cp -r agents/* ~/.kimi/agents/

# Create master agent
cp gsd-agent.yaml ~/.kimi/

🔄 Updating

After Kimi CLI Updates

When Kimi CLI is updated, the patches need to be re-applied:

# Update Kimi CLI
uv tool update kimi-cli

# Re-apply GSD patches
jim --patch

Update GSD Itself

cd gsd-kimi-cli
git pull
node scripts/install.js
jim --patch

📊 Comparison with Official GSD

Functional parity: ~95%

🏗️ Repository Structure

gsd-kimi-cli/
├── skills/              # 27 GSD skills
│   ├── gsd-master/
│   ├── gsd-new-project/
│   └── ...
├── agents/              # 11 GSD agents
│   ├── gsd-executor/
│   ├── gsd-planner/
│   └── ...
├── references/          # 9 knowledge bases
│   ├── questioning.md
│   ├── planning-config.md
│   └── ...
├── workflows/           # Flow skill templates
│   ├── complete-milestone.md
│   └── ...
├── patches/             # Kimi CLI source patches
│   ├── kimi_cli_patcher.py
│   └── jim-wrapper.py
├── scripts/             # Installation scripts
│   └── install.js
├── templates/           # Project templates
├── docs/                # Documentation
└── README.md

🧪 Testing

# Run test suite
npm test

# Verify installation
node scripts/install.js --verify

# Check patch status
jim --status

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

MIT License - see LICENSE file

🙏 Credits

• Original GSD concept by TÂCHES for Claude Code
• Adapted for Kimi CLI by the community

🔗 Links

• GitHub Repository
• Kimi CLI
• Original GSD

Ready to Get Shit Done?

git clone https://github.com/optivent/gsd-kimi-cli.git
cd gsd-kimi-cli
node scripts/install.js
jim --patch
jim