CodeComplete

You can think, you can build.

The only thing you need to think about is what you want to build. Define your requirements clearly — leave the rest to CodeComplete.

🚀 Installation

Install CodeComplete globally:

npm install codecomplete -g

📋 Usage

Start Development Workflow

co start

This command will:

1. 🎯 Guide you through creating a todo list with specific features or bug fixes
2. 🤖 Use Claude Code to implement your requirements
3. 🎭 Verify implementation with Playwright MCP (if available)
4. 📝 Provide next steps for review and commit

Generate Implementation Plan for Cursor

co start --cursor

This command will:

1. 🎯 Guide you through creating a todo list with specific features or bug fixes
2. 🧠 Generate a detailed technical implementation plan using Claude Code
3. 📋 Provide structured specifications for use with Cursor IDE
4. 🎯 Focus on "what to build" while providing clear guidance for "how to build"

Query Claude with Context

co claude "your query here"

This command will:

1. 🔍 Load existing todo list context (if available)
2. 🤖 Call Claude Code with your query and todo context
3. 💡 Get AI assistance that considers your current project requirements

Commit Changes

co commit

This command will:

1. 📄 Generate commit message from your todo list
2. 🔍 Allow you to review before committing
3. 📤 Commit changes to git
4. 🧹 Clean up temporary files

🎨 Features

• Interactive CLI: Colorful, user-friendly command line interface
• Multi-todo Support: Add multiple requirements in one session
• AI Integration: Seamless integration with Claude Code for implementation
• Cursor IDE Support: Generate technical plans for Cursor-based development
• Context-Aware Queries: Query Claude with project todo context
• Smart Branch Management: Automatic git branch creation based on todo content
• Quality Assurance: Optional Playwright MCP verification
• Smart Commits: Auto-generated commit messages from requirements
• Clean Workflow: Automatic cleanup after successful commits

🔧 How It Works

1. Define Requirements: Use co start to create a structured todo list
2. AI Implementation: Claude Code implements your requirements following best practices
3. Verification: Playwright MCP checks if implementation meets requirements
4. Version Control: co commit creates meaningful commits with auto-generated messages

📁 Project Structure

codecomplete/
├── bin/
│   └── co.js          # CLI entry point
├── package.json       # Project configuration
├── README.md         # This file
└── .gitignore        # Git ignore rules

🎯 Philosophy

CodeComplete embodies the principle of "specification over implementation" - developers focus on clearly defining what to build, while AI handles how to build it using industry best practices.

🔄 Workflow Examples

Direct Implementation with Claude Code

# Start a new development session
co start

# Follow prompts to add todos:
# Todo #1: Add user authentication
# Todo #2: Implement password reset
# Todo #3: Add rate limiting
# (Press Enter with empty input to finish)

# Review implemented code
# Test functionality

# Commit when ready
co commit

Generate Plan for Cursor IDE

# Generate technical implementation plan
co start --cursor

# Follow prompts to add todos:
# Todo #1: Add user authentication
# Todo #2: Implement password reset
# Todo #3: Add rate limiting
# (Press Enter with empty input to finish)

# Copy the generated technical plan
# Use the plan with Cursor IDE for implementation

# Commit when ready
co commit

Query with Context

# Create todos first
co start

# Later, query Claude with todo context
co claude "How should I handle authentication errors?"

# Claude will consider your existing todo list when responding

📚 Background

CodeComplete is a command-line tool designed to help developers use AI coding tools more systematically and effectively. It promotes best practices for AI-assisted development by providing a structured workflow from requirements to deployment.