# WarpCoder
**License Notice:** This is commercial software. See pricing tiers below and LICENSE file for full terms.
Universal BDD Project Generator for Claude Code - Transform your ideas into working applications using AI-powered Behavior Driven Development.
## Why WarpCoder?
WarpCoder transforms the software development process into an AI-assisted journey that takes you from idea to working application. It combines:
- **AI-powered development** - Leverage Claude Code to generate, test, and fix code automatically
- **BDD workflow** - Follow a structured process from project initialization to deployment
- **Smart automation** - Automatically detects project state and continues where you left off
- **Full-stack support** - Handles backend, frontend, database, and integration seamlessly
- **Zero configuration** - Installs and configures all dependencies automatically
Whether you're building a new application from scratch or continuing an existing project, WarpCoder manages the entire development lifecycle for you.
## Installation
```bash
pip install warpcoder
```
## Requirements
- Python 3.8 or higher
- Git
- Internet connection (for AI-assisted features and initial setup)
- macOS, Linux, or Windows
## Quick Start
WarpCoder provides multiple ways to start your development journey:
### Direct Goal Specification (Recommended)
```bash
# Specify your goal directly - WarpCoder handles everything else
warpcoder "I want to build a tic tac toe game in python fastapi"
warpcoder "Create a todo app with tags and categories"
warpcoder "Build a REST API for managing books"
```
### Interactive Mode
```bash
# Run without arguments for guided setup
warpcoder
# Or use the menu for all options
warpcoder --menu
```
### Command Shortcuts
The package provides three equivalent commands:
- `warpcoder` - Main command
- `warp` - Short alias
- `warpclaude` - Alternative name
## Command Overview
### Main Commands
| Command | Description |
|---------|-------------|
| `warpcoder "your app idea"` | Start new project with your goal |
| `warpcoder` | Auto-detect and continue existing project |
| `warpcoder --menu` | Show interactive menu with all options |
| `warpcoder --check` | Check installation status (includes MCP servers) |
| `warpcoder --installclaude` | Install Claude Code and dependencies |
| `warpcoder --installmcp` | Install all recommended MCP servers |
| `warpcoder --help` | Show help message |
### Menu Options
When using `--menu`, you'll see:
1. **Quick Start** - Auto initialize and start development
2. **Initialize New Project** - Run bddinit with your app goal
3. **Continue Project** - Run bddwarp development loop
4. **Run Finished Project** - Execute play.py or menu.py
5. **Install Claude Code** - Set up Claude and dependencies
6. **Setup Claude Environment** - Create .claude configuration
7. **Install MCP Servers** - Add Context7, Puppeteer, Magic, Sequence
8. **Create SDK Example** - Generate example SDK usage
9. **Check Installation Status** - Verify all components
10. **Exit**
## How It Works
### Phase 1: Environment Setup
WarpCoder automatically:
- Installs Claude Code globally via npm
- Sets up Node.js if not present (via nvm on Unix)
- Configures MCP servers for enhanced capabilities
- Creates .claude configuration with BDD commands
### Phase 2: Project Initialization (bddinit)
When you provide an app goal, WarpCoder:
- Detects appropriate tech stack (Python/Node/Ruby)
- Creates domain models and architecture documents
- Generates BDD feature files
- Plans implementation with pseudocode
- Sets up testing framework (behave/cucumber)
### Phase 3: Development Loop (bddwarp)
The development loop:
- Runs BDD tests to identify failures
- Generates step definitions
- Implements code to pass tests
- Creates database models and migrations
- Builds API endpoints
- Connects frontend to backend
- Creates user entry points (play.py/menu.py)
- Captures screenshots and documentation
### Phase 4: Delivery
Your completed project includes:
- Working application with all tests passing
- Entry point for easy execution
- Full documentation
- Clean architecture following DDD principles
## Project Structure
WarpCoder creates a well-organized project:
```
your-project/
├── features/ # BDD feature files
│ ├── *.feature # Gherkin scenarios
│ ├── steps/ # Step definitions
│ └── environment.py # Test configuration
├── docs/ # Documentation
│ ├── ddd.md # Domain-Driven Design model
│ ├── state-diagram.md # State flow visualization
│ └── mission.md # Project mission and scope
├── pseudocode/ # Architecture planning
│ ├── main_controller.pseudo
│ ├── data_manager.pseudo
│ └── business_rules.pseudo
├── src/ # Source code (auto-generated)
├── tests/ # Unit tests (auto-generated)
├── play.py # Web app entry point
├── menu.py # CLI app entry point
└── .claude/ # Claude configuration
├── commands/ # Custom BDD commands
├── settings.json
└── settings.local.json
```
## MCP Servers
WarpCoder can install and configure Model Context Protocol (MCP) servers:
- **Context7** - Enhanced memory across Claude sessions
- **Puppeteer** - Browser automation for web testing
- **Magic** - AI-powered development utilities
- **Sequence** - Sequential operation management
Install all MCP servers:
```bash
warpcoder --installmcp
```
## Examples
### Create a New Web Application
```bash
# Direct approach - WarpCoder handles everything
warpcoder "build a recipe sharing platform with user accounts"
```
### Create a CLI Tool
```bash
warpcoder "create a command-line password manager with encryption"
```
### Continue Existing Project
```bash
# In a directory with existing BDD project
warpcoder
# Automatically detects and continues development
```
### Check Environment
```bash
# See what's installed
warpcoder --check
```
## Tech Stack Detection
WarpCoder automatically detects the best tech stack from your goal:
- **Python**: FastAPI, Django, Flask
- **JavaScript**: Express, React, Vue, Next.js
- **Ruby**: Rails
- **Other**: Rust, Go, Java Spring, C#/.NET
## Development
To contribute to WarpCoder:
```bash
git clone https://github.com/starshipagentic/warpcoder.git
cd warpcoder
pip install -e .
```
## Support
- **GitHub**: [https://github.com/starshipagentic/warpcoder](https://github.com/starshipagentic/warpcoder)
- **Issues**: [https://github.com/starshipagentic/warpcoder/issues](https://github.com/starshipagentic/warpcoder/issues)
- **PyPI**: [https://pypi.org/project/warpcoder](https://pypi.org/project/warpcoder)
## License
WarpCoder is commercial software with friendly pricing for individuals and small teams.
### Pricing Tiers
| Your Annual Revenue | Monthly Cost (Entire Organization) | Perfect For |
|---------------------|-----------------------------------|-------------|
| **Personal/Learning** | Free (donation optional) | Students, hobbyists, learning |
| **Up to $100K** | $10/month for entire organization | Individual consultants, freelancers |
| **$100K - $250K** | $25/month for entire organization | Small consultancies, startups |
| **$250K - $500K** | $50/month for entire organization | Growing agencies |
| **$500K+** | Revenue ÷ 1000 per month | Established businesses |
| **$5M+** | Revenue ÷ 1000 per month (max $5K) + training | Enterprise organizations |
**All generated code is yours to keep!**
Payment options:
- **Small tiers**: [Patreon](https://patreon.com/c/starshipagentic) or [Buy Me a Coffee](https://buymeacoffee.com/starshipagentic)
- **Larger tiers**: Multiple coffees or contact starshipagentic@gmail.com
See [LICENSE](LICENSE) for complete terms.
## Credits
Created by Warpcoders LLC
---
*WarpCoder: From idea to application at warp speed with AI-powered BDD*
Raw data
{
"_id": null,
"home_page": null,
"name": "warpcoder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "bdd, claude, testing, development, automation",
"author": null,
"author_email": "Warpcoders LLC <starshipagentic@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/82/c6/05c888808a7d2e42d23e4eba0f1d51a2b60c042469d896154bf537515cd7/warpcoder-0.4.4.tar.gz",
"platform": null,
"description": "# WarpCoder\n\n**License Notice:** This is commercial software. See pricing tiers below and LICENSE file for full terms.\n\nUniversal BDD Project Generator for Claude Code - Transform your ideas into working applications using AI-powered Behavior Driven Development.\n\n## Why WarpCoder?\n\nWarpCoder transforms the software development process into an AI-assisted journey that takes you from idea to working application. It combines:\n\n- **AI-powered development** - Leverage Claude Code to generate, test, and fix code automatically\n- **BDD workflow** - Follow a structured process from project initialization to deployment\n- **Smart automation** - Automatically detects project state and continues where you left off\n- **Full-stack support** - Handles backend, frontend, database, and integration seamlessly\n- **Zero configuration** - Installs and configures all dependencies automatically\n\nWhether you're building a new application from scratch or continuing an existing project, WarpCoder manages the entire development lifecycle for you.\n\n## Installation\n\n```bash\npip install warpcoder\n```\n\n## Requirements\n\n- Python 3.8 or higher\n- Git\n- Internet connection (for AI-assisted features and initial setup)\n- macOS, Linux, or Windows\n\n## Quick Start\n\nWarpCoder provides multiple ways to start your development journey:\n\n### Direct Goal Specification (Recommended)\n```bash\n# Specify your goal directly - WarpCoder handles everything else\nwarpcoder \"I want to build a tic tac toe game in python fastapi\"\nwarpcoder \"Create a todo app with tags and categories\"\nwarpcoder \"Build a REST API for managing books\"\n```\n\n### Interactive Mode\n```bash\n# Run without arguments for guided setup\nwarpcoder\n\n# Or use the menu for all options\nwarpcoder --menu\n```\n\n### Command Shortcuts\nThe package provides three equivalent commands:\n- `warpcoder` - Main command\n- `warp` - Short alias\n- `warpclaude` - Alternative name\n\n## Command Overview\n\n### Main Commands\n\n| Command | Description |\n|---------|-------------|\n| `warpcoder \"your app idea\"` | Start new project with your goal |\n| `warpcoder` | Auto-detect and continue existing project |\n| `warpcoder --menu` | Show interactive menu with all options |\n| `warpcoder --check` | Check installation status (includes MCP servers) |\n| `warpcoder --installclaude` | Install Claude Code and dependencies |\n| `warpcoder --installmcp` | Install all recommended MCP servers |\n| `warpcoder --help` | Show help message |\n\n### Menu Options\n\nWhen using `--menu`, you'll see:\n\n1. **Quick Start** - Auto initialize and start development\n2. **Initialize New Project** - Run bddinit with your app goal\n3. **Continue Project** - Run bddwarp development loop\n4. **Run Finished Project** - Execute play.py or menu.py\n5. **Install Claude Code** - Set up Claude and dependencies\n6. **Setup Claude Environment** - Create .claude configuration\n7. **Install MCP Servers** - Add Context7, Puppeteer, Magic, Sequence\n8. **Create SDK Example** - Generate example SDK usage\n9. **Check Installation Status** - Verify all components\n10. **Exit**\n\n## How It Works\n\n### Phase 1: Environment Setup\nWarpCoder automatically:\n- Installs Claude Code globally via npm\n- Sets up Node.js if not present (via nvm on Unix)\n- Configures MCP servers for enhanced capabilities\n- Creates .claude configuration with BDD commands\n\n### Phase 2: Project Initialization (bddinit)\nWhen you provide an app goal, WarpCoder:\n- Detects appropriate tech stack (Python/Node/Ruby)\n- Creates domain models and architecture documents\n- Generates BDD feature files\n- Plans implementation with pseudocode\n- Sets up testing framework (behave/cucumber)\n\n### Phase 3: Development Loop (bddwarp)\nThe development loop:\n- Runs BDD tests to identify failures\n- Generates step definitions\n- Implements code to pass tests\n- Creates database models and migrations\n- Builds API endpoints\n- Connects frontend to backend\n- Creates user entry points (play.py/menu.py)\n- Captures screenshots and documentation\n\n### Phase 4: Delivery\nYour completed project includes:\n- Working application with all tests passing\n- Entry point for easy execution\n- Full documentation\n- Clean architecture following DDD principles\n\n## Project Structure\n\nWarpCoder creates a well-organized project:\n\n```\nyour-project/\n\u251c\u2500\u2500 features/ # BDD feature files\n\u2502 \u251c\u2500\u2500 *.feature # Gherkin scenarios\n\u2502 \u251c\u2500\u2500 steps/ # Step definitions\n\u2502 \u2514\u2500\u2500 environment.py # Test configuration\n\u251c\u2500\u2500 docs/ # Documentation\n\u2502 \u251c\u2500\u2500 ddd.md # Domain-Driven Design model\n\u2502 \u251c\u2500\u2500 state-diagram.md # State flow visualization\n\u2502 \u2514\u2500\u2500 mission.md # Project mission and scope\n\u251c\u2500\u2500 pseudocode/ # Architecture planning\n\u2502 \u251c\u2500\u2500 main_controller.pseudo\n\u2502 \u251c\u2500\u2500 data_manager.pseudo\n\u2502 \u2514\u2500\u2500 business_rules.pseudo\n\u251c\u2500\u2500 src/ # Source code (auto-generated)\n\u251c\u2500\u2500 tests/ # Unit tests (auto-generated)\n\u251c\u2500\u2500 play.py # Web app entry point\n\u251c\u2500\u2500 menu.py # CLI app entry point\n\u2514\u2500\u2500 .claude/ # Claude configuration\n \u251c\u2500\u2500 commands/ # Custom BDD commands\n \u251c\u2500\u2500 settings.json\n \u2514\u2500\u2500 settings.local.json\n```\n\n## MCP Servers\n\nWarpCoder can install and configure Model Context Protocol (MCP) servers:\n\n- **Context7** - Enhanced memory across Claude sessions\n- **Puppeteer** - Browser automation for web testing\n- **Magic** - AI-powered development utilities\n- **Sequence** - Sequential operation management\n\nInstall all MCP servers:\n```bash\nwarpcoder --installmcp\n```\n\n## Examples\n\n### Create a New Web Application\n```bash\n# Direct approach - WarpCoder handles everything\nwarpcoder \"build a recipe sharing platform with user accounts\"\n```\n\n### Create a CLI Tool\n```bash\nwarpcoder \"create a command-line password manager with encryption\"\n```\n\n### Continue Existing Project\n```bash\n# In a directory with existing BDD project\nwarpcoder\n# Automatically detects and continues development\n```\n\n### Check Environment\n```bash\n# See what's installed\nwarpcoder --check\n```\n\n## Tech Stack Detection\n\nWarpCoder automatically detects the best tech stack from your goal:\n- **Python**: FastAPI, Django, Flask\n- **JavaScript**: Express, React, Vue, Next.js\n- **Ruby**: Rails\n- **Other**: Rust, Go, Java Spring, C#/.NET\n\n## Development\n\nTo contribute to WarpCoder:\n\n```bash\ngit clone https://github.com/starshipagentic/warpcoder.git\ncd warpcoder\npip install -e .\n```\n\n## Support\n\n- **GitHub**: [https://github.com/starshipagentic/warpcoder](https://github.com/starshipagentic/warpcoder)\n- **Issues**: [https://github.com/starshipagentic/warpcoder/issues](https://github.com/starshipagentic/warpcoder/issues)\n- **PyPI**: [https://pypi.org/project/warpcoder](https://pypi.org/project/warpcoder)\n\n## License\n\nWarpCoder is commercial software with friendly pricing for individuals and small teams.\n\n### Pricing Tiers\n\n| Your Annual Revenue | Monthly Cost (Entire Organization) | Perfect For |\n|---------------------|-----------------------------------|-------------|\n| **Personal/Learning** | Free (donation optional) | Students, hobbyists, learning |\n| **Up to $100K** | $10/month for entire organization | Individual consultants, freelancers |\n| **$100K - $250K** | $25/month for entire organization | Small consultancies, startups |\n| **$250K - $500K** | $50/month for entire organization | Growing agencies |\n| **$500K+** | Revenue \u00f7 1000 per month | Established businesses |\n| **$5M+** | Revenue \u00f7 1000 per month (max $5K) + training | Enterprise organizations |\n\n**All generated code is yours to keep!**\n\nPayment options:\n- **Small tiers**: [Patreon](https://patreon.com/c/starshipagentic) or [Buy Me a Coffee](https://buymeacoffee.com/starshipagentic)\n- **Larger tiers**: Multiple coffees or contact starshipagentic@gmail.com\n\nSee [LICENSE](LICENSE) for complete terms.\n\n## Credits\n\nCreated by Warpcoders LLC\n\n---\n\n*WarpCoder: From idea to application at warp speed with AI-powered BDD*\n",
"bugtrack_url": null,
"license": "Proprietary",
"summary": "Universal BDD Project Generator for Claude Code",
"version": "0.4.4",
"project_urls": {
"Homepage": "https://github.com/starshipagentic/warpcoder",
"Issues": "https://github.com/starshipagentic/warpcoder/issues",
"Repository": "https://github.com/starshipagentic/warpcoder"
},
"split_keywords": [
"bdd",
" claude",
" testing",
" development",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5cc992c238704e9a52afdc8dac1d0b3bda6668b2bc4fa87c29442578f5ce81c7",
"md5": "cfee6c19814ddf26a2c711fe7ea69ef6",
"sha256": "d1da5583db03a814c87b6b823f29fae95c8d0360a0f16d8d5dc8ae7ce2b55673"
},
"downloads": -1,
"filename": "warpcoder-0.4.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cfee6c19814ddf26a2c711fe7ea69ef6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 74561,
"upload_time": "2025-09-06T07:24:55",
"upload_time_iso_8601": "2025-09-06T07:24:55.132897Z",
"url": "https://files.pythonhosted.org/packages/5c/c9/92c238704e9a52afdc8dac1d0b3bda6668b2bc4fa87c29442578f5ce81c7/warpcoder-0.4.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "82c605c888808a7d2e42d23e4eba0f1d51a2b60c042469d896154bf537515cd7",
"md5": "30e5609e726f092181fe79259b8f58b0",
"sha256": "eb4a9131b8cbaa9477bdaac0bb00870c0d49ad8ab3e74d20cf92a0bb00ec36cc"
},
"downloads": -1,
"filename": "warpcoder-0.4.4.tar.gz",
"has_sig": false,
"md5_digest": "30e5609e726f092181fe79259b8f58b0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 67134,
"upload_time": "2025-09-06T07:24:56",
"upload_time_iso_8601": "2025-09-06T07:24:56.476388Z",
"url": "https://files.pythonhosted.org/packages/82/c6/05c888808a7d2e42d23e4eba0f1d51a2b60c042469d896154bf537515cd7/warpcoder-0.4.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-06 07:24:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "starshipagentic",
"github_project": "warpcoder",
"github_not_found": true,
"lcname": "warpcoder"
}
JSON
