# WarpCoder
Universal BDD Project Generator for Claude Code - Automatically sets up Claude Code environment and manages BDD development lifecycle.
## Installation
```bash
pip install warpcoder
```
## Quick Start
After installation, you can use either `warp` or `warpclaude` command:
```bash
# Auto-run based on project state
warp
# Show interactive menu
warp --menu
# Check installation status
warp --check
```
## Features
- ✨ **Auto-Setup**: Automatically installs Claude Code, Node.js, and dependencies
- 🚀 **BDD Workflow**: Complete BDD project initialization and development loop
- 🧠 **Context7 Integration**: Enhanced memory management for Claude
- 🎮 **Interactive Menu**: User-friendly interface for all operations
- 📦 **Smart Detection**: Automatically detects and continues existing projects
## What It Does
WarpCoder automates the entire BDD (Behavior Driven Development) workflow:
1. **Environment Setup**: Ensures Claude Code, Node.js, and BDD frameworks are installed
2. **Project Initialization**: Creates domain models, state diagrams, and feature files
3. **Development Loop**: Iteratively implements code to pass BDD tests
4. **Full Stack**: Handles backend, frontend, and integration automatically
## Commands
### Default Behavior
```bash
warp
```
- If BDD project exists: Continues development (100 iterations)
- If no project: Starts interactive initialization
### Interactive Menu
```bash
warp --menu
```
Shows options for:
- Quick Start (Auto Init + Development)
- Initialize New Project
- Continue Existing Project
- Run Finished Project
- Setup Environment Only
- Create SDK Example
- Check Installation Status
### Check Status
```bash
warp --check
```
Verifies installation of all components.
## Project Structure
When you initialize a new project, WarpCoder creates:
```
your-project/
├── features/ # BDD feature files
│ └── steps/ # Step definitions
├── docs/ # Documentation
│ ├── ddd.md # Domain model
│ ├── state-diagram.md
│ └── mission.md
├── pseudocode/ # Architecture planning
└── .claude/ # Claude configuration
└── commands/ # Custom commands
```
## Requirements
- Python 3.8+
- Internet connection (for initial setup)
- macOS, Linux, or Windows
## How It Works
1. **Setup Phase**: Installs missing dependencies (Claude Code, Node.js via nvm)
2. **Init Phase**: Analyzes your app goal and creates minimal BDD structure
3. **Development Phase**: Runs tests, implements code, verifies full stack
4. **Delivery Phase**: Creates entry points (play.py/menu.py) for easy execution
## License
MIT License
## Contributing
Contributions welcome! Please submit issues and pull requests on GitHub.
## Support
For issues, questions, or suggestions, please visit our GitHub repository.
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": "Your Name <your.email@example.com>",
"download_url": "https://files.pythonhosted.org/packages/65/d1/b64858f6c8aec2dc70f295ce313f870d8f31c9629049c7c2e2ed914e1d8d/warpcoder-0.1.5.tar.gz",
"platform": null,
"description": "# WarpCoder\n\nUniversal BDD Project Generator for Claude Code - Automatically sets up Claude Code environment and manages BDD development lifecycle.\n\n## Installation\n\n```bash\npip install warpcoder\n```\n\n## Quick Start\n\nAfter installation, you can use either `warp` or `warpclaude` command:\n\n```bash\n# Auto-run based on project state\nwarp\n\n# Show interactive menu\nwarp --menu\n\n# Check installation status\nwarp --check\n```\n\n## Features\n\n- \u2728 **Auto-Setup**: Automatically installs Claude Code, Node.js, and dependencies\n- \ud83d\ude80 **BDD Workflow**: Complete BDD project initialization and development loop\n- \ud83e\udde0 **Context7 Integration**: Enhanced memory management for Claude\n- \ud83c\udfae **Interactive Menu**: User-friendly interface for all operations\n- \ud83d\udce6 **Smart Detection**: Automatically detects and continues existing projects\n\n## What It Does\n\nWarpCoder automates the entire BDD (Behavior Driven Development) workflow:\n\n1. **Environment Setup**: Ensures Claude Code, Node.js, and BDD frameworks are installed\n2. **Project Initialization**: Creates domain models, state diagrams, and feature files\n3. **Development Loop**: Iteratively implements code to pass BDD tests\n4. **Full Stack**: Handles backend, frontend, and integration automatically\n\n## Commands\n\n### Default Behavior\n```bash\nwarp\n```\n- If BDD project exists: Continues development (100 iterations)\n- If no project: Starts interactive initialization\n\n### Interactive Menu\n```bash\nwarp --menu\n```\nShows options for:\n- Quick Start (Auto Init + Development)\n- Initialize New Project\n- Continue Existing Project\n- Run Finished Project\n- Setup Environment Only\n- Create SDK Example\n- Check Installation Status\n\n### Check Status\n```bash\nwarp --check\n```\nVerifies installation of all components.\n\n## Project Structure\n\nWhen you initialize a new project, WarpCoder creates:\n\n```\nyour-project/\n\u251c\u2500\u2500 features/ # BDD feature files\n\u2502 \u2514\u2500\u2500 steps/ # Step definitions\n\u251c\u2500\u2500 docs/ # Documentation\n\u2502 \u251c\u2500\u2500 ddd.md # Domain model\n\u2502 \u251c\u2500\u2500 state-diagram.md\n\u2502 \u2514\u2500\u2500 mission.md\n\u251c\u2500\u2500 pseudocode/ # Architecture planning\n\u2514\u2500\u2500 .claude/ # Claude configuration\n \u2514\u2500\u2500 commands/ # Custom commands\n```\n\n## Requirements\n\n- Python 3.8+\n- Internet connection (for initial setup)\n- macOS, Linux, or Windows\n\n## How It Works\n\n1. **Setup Phase**: Installs missing dependencies (Claude Code, Node.js via nvm)\n2. **Init Phase**: Analyzes your app goal and creates minimal BDD structure\n3. **Development Phase**: Runs tests, implements code, verifies full stack\n4. **Delivery Phase**: Creates entry points (play.py/menu.py) for easy execution\n\n## License\n\nMIT License\n\n## Contributing\n\nContributions welcome! Please submit issues and pull requests on GitHub.\n\n## Support\n\nFor issues, questions, or suggestions, please visit our GitHub repository.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Universal BDD Project Generator for Claude Code",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/yourusername/warpcoder",
"Issues": "https://github.com/yourusername/warpcoder/issues",
"Repository": "https://github.com/yourusername/warpcoder"
},
"split_keywords": [
"bdd",
" claude",
" testing",
" development",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e9f83f28c64dcce47f34ac34f92b22c29739433452febe8986964dd557138b50",
"md5": "c6626d2361045c8ff8afd0f91e2dcf86",
"sha256": "5827b9b4ffebecbdd3ea9fa6ef86955f43fa3c55a56650b1b7694a76b14fab34"
},
"downloads": -1,
"filename": "warpcoder-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6626d2361045c8ff8afd0f91e2dcf86",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 17324,
"upload_time": "2025-07-09T04:44:00",
"upload_time_iso_8601": "2025-07-09T04:44:00.505339Z",
"url": "https://files.pythonhosted.org/packages/e9/f8/3f28c64dcce47f34ac34f92b22c29739433452febe8986964dd557138b50/warpcoder-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "65d1b64858f6c8aec2dc70f295ce313f870d8f31c9629049c7c2e2ed914e1d8d",
"md5": "fb77ba0cb7adeff50d97a96b3802b121",
"sha256": "a517d8d56840348b8fffa2e701e2029de906c1e4f4874ebb8000fc5db403c104"
},
"downloads": -1,
"filename": "warpcoder-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "fb77ba0cb7adeff50d97a96b3802b121",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 18047,
"upload_time": "2025-07-09T04:44:01",
"upload_time_iso_8601": "2025-07-09T04:44:01.292108Z",
"url": "https://files.pythonhosted.org/packages/65/d1/b64858f6c8aec2dc70f295ce313f870d8f31c9629049c7c2e2ed914e1d8d/warpcoder-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 04:44:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "warpcoder",
"github_not_found": true,
"lcname": "warpcoder"
}