AI-powered code completion CLI tool - You can think, you can build
npm install 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.
Install CodeComplete globally:
``bash`
npm install codecomplete -g
bash
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$3
`bash
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"$3
`bash
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$3
`bash
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
$3
`bash
Start a new development session
co startFollow 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
`$3
`bash
Generate technical implementation plan
co start --cursorFollow 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
`$3
`bash
Create todos first
co startLater, query Claude with todo context
co claude "How should I handle authentication errors?"Claude will consider your existing todo list when responding
``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.