WarpCode
🚀 Warp through development cycles with automated BDD and Claude Coder 🚀
A Python CLI tool that orchestrates Claude Code to automatically implement BDD scenarios with zero human intervention, real-time monitoring, and robust fake implementation detection.
✨ Key Features
- 🔄 Fully Automated BDD Development - Zero human intervention once started
- 📞 Conversation Continuity - Claude maintains context across iterations with
-cflag support - 📊 Real-time OpenTelemetry Monitoring - Live Claude activity tracking with OTEL events
- 🔍 Reality Validation - Comprehensive fake implementation detection and prevention
- 🤖 Claude Integration - Automated Claude Code execution with enhanced debugging
- 🧪 BDD Test Management - Behave integration with intelligent pass/fail parsing
- 📈 Code Quality Assurance - Radon integration for complexity monitoring
- 🎨 Beautiful CLI - Rich console output with real-time progress indicators
🚀 Quick Start
Installation
pip install warpcode
Basic Usage
# Run WarpCode with interactive setup
warpcode
# Or use the shorter alias
warp
# Enable debug mode for comprehensive Claude activity visibility
WARPCODE_DEBUG=1 warpcode
# Enable verbose output to see all Claude interactions
WARPCODE_VERBOSE=1 warpcode
📊 Real-time Monitoring
WarpCode provides multiple levels of monitoring:
1. Live Activity Dashboard
Real-time display showing:
- Current BDD test status
- Claude conversation state
- Active tool executions
- Reality validation results
2. OpenTelemetry Integration
Captures and displays:
claude_code.user_prompt- When prompts are sentclaude_code.tool_result- Tool execution resultsclaude_code.api_request- API calls with token countsclaude_code.tool_decision- Permission decisions
3. Debug Modes
# Show full Claude command execution details
export WARPCODE_DEBUG=1
# Display all Claude output in real-time
export WARPCODE_VERBOSE=1
# Both modes together for maximum visibility
export WARPCODE_DEBUG=1 WARPCODE_VERBOSE=1
🔍 Reality Validation
WarpCode prevents fake implementations through:
- Pattern Detection - Scans for HTML mocks, hardcoded responses, simulation code
- Behavioral Testing - Verifies tests actually depend on implementation files
- Subprocess Validation - Ensures proper error handling in system calls
- Mock File Detection - Identifies files with excessive hardcoded content
- Conversation Reset - Clears Claude state when fake patterns are detected
🎯 Architecture Overview
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Environment │ │ Orchestrator │ │ Claude Code │
│ Manager │◄──►│ Loop │◄──►│ Interface │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ BDD Runner │ │ Scoreboard │ │ Reality │
│ (Behave) │ │ Manager │ │ Validator │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
└────────────────────────┼───────────────────────┘
▼
┌──────────────────┐
│ Activity Dashboard│
│ (Real-time UI) │
└──────────────────┘
📁 Project Structure
your-project/
├── features/ # BDD feature files
│ ├── environment.py # Behave configuration
│ ├── steps/ # Step definitions
│ └── *.feature # Gherkin scenarios
├── scoreboards/ # Real-time status JSON files
│ ├── master_status.json # Overall orchestration state
│ ├── bdd_status.json # Test execution results
│ ├── claude_status.json # Claude activity tracking
│ └── validation_*.json # Reality validation reports
├── venv/ # Virtual environment
├── behave.ini # Behave configuration
└── .warpcode_conversation_id # Claude conversation state
🔄 How It Works
- Smart Environment Setup - Detects existing setup, only installs missing components
- Conversation Continuity - Loads existing Claude conversation or starts new one
- BDD Execution - Runs behave tests with real-time progress monitoring
- Claude Orchestration - Sends focused prompts with anti-fake enforcement
- Reality Validation - Scans for fake patterns, validates behavioral dependencies
- Iterative Improvement - Feeds validation failures back to enhance next iteration
📋 Requirements
- Python 3.10+
- Claude Code CLI (authenticated and available in PATH)
- Git (for project management)
🛠️ Development
# Install in development mode
git clone https://github.com/warpcodedev/warpcode
cd warpcode
pip install -e .
# Run with debug output
WARPCODE_DEBUG=1 warpcode
📝 Release Notes
v1.1.0 (Latest) - Advanced Fake Detection & Red-Green BDD
- ✅ LLM-Powered Fake Detection: Claude analyzes step files to catch sophisticated fakes
- ✅ Dual-Phase Validation: Combines regex patterns + LLM analysis for comprehensive detection
- ✅ Red-Green BDD Enforcement: Proper TDD workflow requiring tests to fail first
- ✅ Two-Phase Claude Workflow: Phase 1: Analyze fakes, Phase 2: Implement real code
- ✅ Cross-Validation System: Validates WarpCode parsing against actual behave execution
- ✅ Enhanced Behavioral Testing: File dependency tests, scenario isolation, truth verification
- ✅ Comprehensive Fake Reports: Auto-generates
fakesteps.mddocumentation
v1.0.9 - Comprehensive Monitoring & Conversation Continuity
- ✅ Conversation Continuity: Claude maintains context with
-cflag support - ✅ Real-time OTEL Monitoring: Live OpenTelemetry event parsing and display
- ✅ Enhanced Reality Validation: Behavioral testing and fake pattern learning
- ✅ Smart Environment Setup: Prevents unnecessary re-initialization
- ✅ Comprehensive Debug Output: Full Claude activity visibility with timestamps
- ✅ Validation Feedback Loop: Failed validations inform subsequent prompts
v1.0.8 - Reality Validation Foundation
- ✅ Reality Validator: Comprehensive fake implementation detection
- ✅ Enhanced Claude Prompts: Strict anti-mock enforcement with time limits
- ✅ Improved Monitoring: Initial OpenTelemetry integration
v1.0.7 - Enhanced Dashboard & Monitoring
- ✅ Activity Dashboard: Real-time UI progress tracking
- ✅ Scoreboard Management: JSON-based status persistence
- ✅ Claude Interface: Automated execution with log monitoring
v1.0.6 - Core BDD Integration
- ✅ BDD Runner: Behave integration with result parsing
- ✅ Environment Manager: Virtual environment and dependency handling
- ✅ Basic Orchestration: Multi-iteration Claude execution loop
Earlier Versions (v1.0.0 - v1.0.5)
- Initial project setup and basic functionality
🎛️ Configuration Options
Environment Variables
WARPCODE_DEBUG=1 # Enable comprehensive debug output
WARPCODE_VERBOSE=1 # Show all Claude interactions
ANTHROPIC_API_KEY=... # Claude API authentication
Debug Features
- Full Command Logging: See exact Claude Code CLI invocations
- Real-time Output: Live Claude response streaming with timestamps
- Conversation Tracking: Monitor conversation ID persistence
- OTEL Event Parsing: Detailed OpenTelemetry event breakdown
- Validation Reports: Comprehensive fake implementation analysis
🔗 Links
- PyPI: https://pypi.org/project/warpcode/
- GitHub: https://github.com/warpcodedev/warpcode
- Issues: https://github.com/warpcodedev/warpcode/issues
- Documentation: https://github.com/warpcodedev/warpcode#readme
📄 License
MIT License - see LICENSE file for details.
🤝 Contributing
- Fork the repository
- Create a feature branch
- Add tests for new functionality
- Submit a pull request
Built with ❤️ for automated BDD development
Zero human intervention. Real implementations only. Maximum development velocity.
Metadata
Release files for warpcode 1.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| warpcode-1.1.5.tar.gz | 66.7 kB | Without provenance | Details for warpcode-1.1.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| warpcode-1.1.5-py3-none-any.whl | Python 3 | none | any | Details for warpcode-1.1.5-py3-none-any.whl |
Total release size: 140.0 kB
Release files / warpcode-1.1.5.tar.gz
| Download URL | warpcode-1.1.5.tar.gz |
|---|---|
| Size | 66.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
69feab9d4d3e8863143f4b291b2ecfdbab4fd2a034ecf03b2ea66e1cda85d0cf
|
|
BLAKE2b-256 checksum How to use checksums |
6ab9f9c7887582f101d22f356c67e0403b8a8f532f015861f3320371aaaa9730
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Release files / warpcode-1.1.5-py3-none-any.whl
| Download URL | warpcode-1.1.5-py3-none-any.whl |
|---|---|
| Size | 73.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
30d3dd4c5420503df23a6084c9a721127fcb3613ed1dd4ee997088974ffdbfda
|
|
BLAKE2b-256 checksum How to use checksums |
846d96e5290b29dbcc9a765843fda30a222931123c2761197550ad5021bed3b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Security for warpcode 1.1.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.