ClaudeKit Cheatsheet

Quick reference guide for ClaudeKit CLI commands and workflows.

Installation

# Install ClaudeKit globally
npm i -g claudekit-cli@latest

# Check version
ck --version

Starting ClaudeKit

# Navigate to your project
cd /path/to/project

# Start Claude Code with ClaudeKit
claude

Initial Setup

# For existing projects (brownfield)
/docs:init

# For new projects (greenfield)
ck init --kit engineer --dir /path/to/project

Core Commands

Development

# Initialize documentation and specs
/docs:init

# Implement new feature
/cook <description>

# Autonomous feature implementation
/cook:auto <description>

# Fast autonomous mode (less planning)
/cook:auto:fast <description>

# Create implementation plan only
/plan <description>

# Execute existing plan
/code <plan.md>

# Bootstrap new project
/bootstrap <idea-description>

# Autonomous bootstrap
/bootstrap:auto <idea-description>

Bug Fixing

# Quick bug fix
/fix:fast <description>

# Complex bug fix (deeper analysis)
/fix:hard <description>

# Auto-fetch logs and fix
/fix:logs

# Run test suite and fix until passing
/fix:test

# Fix CI/CD pipeline issues
/fix:ci <github-action-url>

Testing

# Run test suite and report (no fixes)
/test

Documentation

# Initialize documentation
/docs:init

# Update documentation
/docs:update

# Summarize documentation
/docs:summarize

Git Operations

# Create commit with meaningful message
/git:cm

# Commit and push changes
/git:cp

# Create pull request
/git:pr

Planning & Research

# Brainstorm technical approaches
/brainstorm <description>

# Create detailed implementation plan
/plan <description>

# Plan CI/CD setup or fix CI/CD pipeline
/plan:ci

# Two-step implementation plan
/plan:two

Integration

# Integrate Polar API
/integrate:polar

# Integrate SePay payment
/integrate:sepay

Skills Management

# Create new skill
/skill:create

# Fix skill errors
/skill:fix-logs

Command Comparison

Feature Implementation Flow

# Approach 1: With plan review (recommended)
/cook <feature-description>
# → CC asks questions
# → Review plan
# → Approve
# → Implementation starts

# Approach 2: Autonomous (use with caution)
/cook:auto <feature-description>
# → Full autonomous without plan review

# Approach 3: Fast autonomous (least tokens)
/cook:auto:fast <feature-description>
# → Fast mode with minimal planning

Bug Fixing Flow

# Simple bugs
/fix:fast <bug-description>

# Complex bugs
/fix:hard <bug-description>

# From logs
/fix:logs

# From failing tests
/fix:test

# From CI/CD
/fix:ci <action-url>

Common Workflows

Brownfield Project Setup

# 1. Install ClaudeKit
npm i -g claudekit-cli@latest

# 2. Go to project
cd /path/to/existing/project

# 3. Start Claude Code
claude

# 4. Initialize
/docs:init

# 5. Start working
/cook <feature>

Greenfield Project Setup

# 1. Install ClaudeKit
npm i -g claudekit-cli@latest

# 2. Initialize project
ck init --kit engineer --dir /path/to/project

# 3. Navigate to project
cd /path/to/project

# 4. Start Claude Code
claude

# 5. Bootstrap idea
/bootstrap <idea-description>

# 6. Continue development
/cook <next-feature>

Feature Development

# 1. Plan feature
/plan Add user profile with avatar upload

# 2. Review plan (markdown file generated)

# 3. Implement
/code profile-feature-plan.md

# 4. Test
/test

# 5. Fix if needed
/fix:test

# 6. Commit
/git:cm

Bug Fix Workflow

# 1. Describe bug
/fix:hard Payment fails on Safari after form validation

# 2. CC analyzes and fixes

# 3. Test the fix
/test

# 4. Commit
/git:cm

CI/CD Fix Workflow

# 1. Get failing action URL
# https://github.com/user/repo/actions/runs/12345

# 2. Fix CI
/fix:ci https://github.com/user/repo/actions/runs/12345

# 3. CC fetches logs, analyzes, fixes

# 4. Push fix
/git:cp

Quick Examples

Add Authentication

/cook Add JWT authentication with login, register, and password reset

Fix Performance Issue

/fix:hard Dashboard loads slowly with 1000+ items

Plan Database Migration

/plan Migrate from MongoDB to PostgreSQL with zero downtime

Integrate Payment

/integrate stripe
# or
/cook Add Stripe payment integration with subscription billing

Bootstrap New API

/bootstrap REST API for task management with teams, projects, tasks, and time tracking

Command Categories

🚀 Core Development

/cook - Feature implementation
/plan - Create plans
/code - Execute plans
/bootstrap - New projects

🐛 Debugging & Fixing

/fix:fast - Quick fixes
/fix:hard - Complex fixes
/fix:logs - Log-based fixes
/fix:test - Test-based fixes
/fix:ci - CI/CD fixes

🧪 Testing

/test - Run tests

📚 Documentation

/docs:init - Initialize
/docs:update - Update
/docs:summarize - Summarize

🔧 Git Operations

/git:cm - Commit changes
/git:cp - Commit and push
/git:pr - Create PR

💡 Planning

/plan - Detailed planning
/brainstorm - Explore ideas

🔌 Integrations

/integrate <service> - Add integrations

⚙️ Skills

/skill:create - New skills
/skill:fix-logs - Fix skills

Tips & Best Practices

1. Always Review Plans

IMPORTANT: Review implementation plans carefully before approving. Plans exist for a reason.

2. Provide Context

More detailed descriptions = better results

# ❌ Bad
/cook Add search

# ✅ Good
/cook Add full-text search for blog posts with filters by category, tag, and date range

3. Use Right Command

# Quick bugs
/fix:fast <simple-issue>

# Complex bugs
/fix:hard <complex-issue>

# Small features
/cook <feature>

# Large features
/plan <feature> → review → /code plan.md

4. Test Frequently

# After each feature
/test

# Or auto-fix tests
/fix:test

5. Document Changes

# Keep docs updated
/docs:update

Troubleshooting

Command Not Working

# Check ClaudeKit version
ck --version

# Restart Claude Code
# Exit and run: claude

Need Fresh Start

# Reinitialize docs
/docs:init

Need More Help

# Brainstorm approach
/brainstorm How to implement <complex-feature>

# Get detailed plan
/plan <what-you-want-to-do>

Language-Specific Quick Reference

Tiếng Việt

# Khởi tạo dự án có sẵn
/docs:init

# Tính năng mới (cần review plan)
/cook <mô-tả-tính-năng>

# Tính năng mới (tự động, ko review)
/cook:auto <mô-tả>

# Tính năng mới (nhanh hơn, ít plan hơn)
/cook:auto:fast <mô-tả>

# Chỉ lên plan, không code
/plan <mô-tả>

# Code theo plan có sẵn
/code <plan.md>

# Sửa lỗi nhanh
/fix:fast <mô-tả-lỗi>

# Sửa lỗi khó (suy nghĩ lâu hơn)
/fix:hard <mô-tả-lỗi>

# Tự lấy logs và sửa
/fix:logs

# Chạy test và sửa tới chết
/fix:test

# Lấy logs GitHub Actions và sửa
/fix:ci <github-action-url>

# Tạo dự án mới (cần review plan)
/bootstrap <ý-tưởng>

# Tạo dự án mới (tự động tới chết)
/bootstrap:auto <ý-tưởng>

# Chạy test và báo cáo (không sửa)
/test

English

# Initialize existing project
/docs:init

# New feature (needs plan review)
/cook <feature-description>

# New feature (autonomous, no review)
/cook:auto <description>

# New feature (faster, less planning)
/cook:auto:fast <description>

# Only plan, no implementation
/plan <description>

# Code from existing plan
/code <plan.md>

# Quick bug fix
/fix:fast <bug-description>

# Hard bug fix (deeper analysis)
/fix:hard <bug-description>

# Auto-fetch logs and fix
/fix:logs

# Run tests and fix till passing
/fix:test

# Fetch GitHub Actions logs and fix
/fix:ci <github-action-url>

# Create new project (needs plan review)
/bootstrap <idea-description>

# Create new project (autonomous till death)
/bootstrap:auto <idea>

# Run test suite and report (no fixes)
/test

Resources

Print this page or keep it open while working with ClaudeKit for quick command reference!