AI-powered VS Code extension for BDD test automation. Record test scenarios with AI assistance and Replay them instantly - no manual coding required!
✨ Features
- 🎥 AI-Powered Recording - Write Gherkin scenarios, let AI generate automation code
- ▶️ One-Click Replay - Execute recorded scenarios directly from feature files
- 🔧 Multi-Platform Support - Windows (browser), Appium (macOS & Mobile)
- 🤖 MCP Integration - Seamless GitHub Copilot connection via Model Context Protocol
- 🎯 Interactive CodeLens - Record and replay buttons above each scenario
- 📝 Natural Language Tasks - Execute automation from plain English descriptions
👨💻 For Developers: See CONTRIBUTING.md for development setup and contribution guidelines.
🚀 Setup Guide
Step 1: Install Extension
Open VS Code Extensions (Ctrl+Shift+X / Cmd+Shift+X) → Search "BDD AI Toolkit" → Install
Step 2: Setup Environment
Open Setup Panel
Click the BDD AI Toolkit icon in the Activity Bar (left sidebar)
Auto-Resolve Environment
The setup panel will automatically detect and resolve environment issues:
- Python installation
- Node.js installation
- Required dependencies
Click "Auto-Resolve" if any issues are detected
Choose Platform & Click Setup
Select your target platform:
- Windows - Browser automation
- Appium - For macOS and mobile testing (iOS/Android)
Click "Setup" button to configure the selected platform
Open Configuration File
Click "Open" button to view/edit the MCP configuration file
The config file will be opened in the editor
Start MCP Server
In the opened configuration file, click the "Start" button (CodeLens action)
This launches the MCP server
Verify Connection in GitHub Copilot
- Open GitHub Copilot Chat
- Check MCP connections panel
- Confirm "BDD AI Toolkit MCP" is connected
Step 3: Record & Replay
Now you're ready to use AI-powered test automation!
Recording (AI generates code):
- Create/open a
.feature file
- Write your scenario in Gherkin
- Click "Send to Copilot" above the scenario
- AI generates automation code automatically
Replaying (Execute tests):
- Open a
.feature file with recorded scenarios
- Click "Run" above any scenario
- Watch the automation execute!
🎯 Advanced Features
Natural Language Tasks
Execute ad-hoc automation without writing scenarios:
Command: BDD AI Toolkit: Execute Natural Language Task
Example:
"Open Chrome, go to google.com, search for 'AI testing', click first result"
AI converts your description to automation and executes immediately.
Custom Copilot Prompt
Customize how AI generates code:
{
"bddAiToolkit.cucumber.copilotPrompt": "Generate step definitions for:\n\n${scenario_text}\n\nFile: ${feature_file_path}\n\nUse Behave framework and follow PEP 8 style."
}
Available placeholders:
${scenario_text} - Full scenario content${feature_file_path} - Path to feature file
📚 Resources
📄 License
MIT License - See LICENSE
Happy Testing! 🎉
