LaunchMate 🚀
AI-Powered Project Setup Assistant for Visual Studio Code
LaunchMate is an intelligent VS Code extension that analyzes your project and provides step-by-step guided setup instructions using Google Gemini AI. Say goodbye to confusing README files and hello to interactive, personalized onboarding!
✨ Features
- 🤖 AI-Powered Analysis - Uses Google Gemini to intelligently understand your project structure
- 📋 Step-by-Step Guidance - Interactive webview with clear, actionable setup instructions
- 🎨 Modern Dark UI - Beautiful, easy-to-navigate interface with smooth animations
- 🔧 Multi-Stack Support - Works with Node.js, Python, Java, C#, Ruby, PHP, Go, Rust, C/C++ and more
- 🔐 Secure API Key Management - Your own Gemini API key, securely stored in settings
- 💡 Smart Detection - Automatically identifies if your project needs setup or is ready to use
- ⚡ Fast & Efficient - Quick project scanning with minimal overhead
📦 Installation
Method 1: From VS Code Marketplace (Recommended)
- Open VS Code
- Click the Extensions icon in the sidebar (or press
Ctrl+Shift+X)
- Search for "LaunchMate"
- Click Install
Method 2: From Command Line
code --install-extension YOUR-PUBLISHER-NAME.launchmate
Method 3: Manual Installation (For Development)
- Clone or download this repository
- Open terminal in the extension folder
- Run:
npm install
npm run compile
- Press
F5 in VS Code to open Extension Development Host
🚀 Quick Start
Step 1: Get Your Gemini API Key
- Visit Google AI Studio
- Sign in with your Google account
- Click "Create API Key"
- Copy the generated key (starts with
AIza...)
💡 Note: Gemini API is FREE to use with generous limits!
- Open VS Code
- Press
Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
- Type: "LaunchMate: Set Gemini API Key"
- Paste your API key
- Press Enter
Alternative: Set via Settings
- Go to
Settings → Extensions → LaunchMate
- Enter your API key in the "Gemini API Key" field
Step 3: Run LaunchMate
- Open any project folder in VS Code
- Press
Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
- Type: "Start LaunchMate"
- Press Enter
- Follow the interactive setup steps!
🎯 How It Works
- Project Scan - Analyzes files like
package.json, requirements.txt, pom.xml, etc.
- AI Analysis - Sends project structure to Google Gemini AI
- Step Generation - AI creates personalized setup instructions
- Interactive Guide - Navigate through steps with Back/Next/Skip buttons
- Complete Setup - Follow each step to configure your project perfectly!
🛠️ Supported Tech Stacks
| Language/Framework |
Detected Files |
Setup Support |
| Node.js/JavaScript |
package.json |
✅ npm/yarn install |
| Python |
requirements.txt, setup.py |
✅ pip install |
| Java |
pom.xml, build.gradle |
✅ Maven/Gradle |
| C#/.NET |
.csproj, .sln |
✅ NuGet restore |
| Ruby |
Gemfile |
✅ Bundle install |
| PHP |
composer.json |
✅ Composer install |
| Go |
go.mod |
✅ Go modules |
| Rust |
Cargo.toml |
✅ Cargo build |
| C/C++ |
CMakeLists.txt, Makefile |
✅ Build setup |
And many more! The AI adapts to any project structure.
📖 Usage Examples
Example 1: Node.js Project
1. Run: npm install
2. Create .env file with: PORT=3000
3. Run: npm run dev
Example 2: Python Project
1. Create virtual environment: python -m venv venv
2. Activate: source venv/bin/activate (Linux/Mac) or venv\Scripts\activate (Windows)
3. Install dependencies: pip install -r requirements.txt
4. Run: python app.py
Example 3: Ready-to-Use Project
✅ Your project appears to be ready to use! No additional setup steps are required.
⌨️ Commands
| Command |
Description |
Start LaunchMate |
Launch the project setup wizard |
LaunchMate: Set Gemini API Key |
Configure or update your Gemini API key |
⚙️ Configuration
Access settings via: File → Preferences → Settings → Extensions → LaunchMate
| Setting |
Type |
Description |
Default |
launchmate.geminiApiKey |
string |
Your Google Gemini API key |
"" |
🔒 Privacy & Security
- ✅ Your API key is stored locally in VS Code settings
- ✅ No API keys are shared or transmitted to third parties
- ✅ Only project file names and structures are sent to Gemini API
- ✅ No source code is transmitted unless explicitly in config files
- ✅ You control your own API key and usage
🐛 Troubleshooting
"LaunchMate requires a Gemini API key"
Solution: Run LaunchMate: Set Gemini API Key command and enter your key.
"Gemini API analysis failed"
Solutions:
- Check your internet connection
- Verify your API key is valid
- Ensure you haven't exceeded Gemini API rate limits
Extension doesn't start
Solutions:
- Reload VS Code window (
Ctrl+Shift+P → Reload Window)
- Check VS Code version (requires 1.70.0+)
- Reinstall the extension
Shows "undefined" steps
Solution: This has been fixed in version 1.0.0+. Update to the latest version.
🤝 Contributing
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
Development Setup
# Clone the repository
git clone https://github.com/YOUR-USERNAME/launchmate.git
cd launchmate
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Run in development mode
# Press F5 in VS Code to open Extension Development Host
📝 Changelog
Version 1.0.0
- 🎉 Initial release
- ✅ AI-powered project analysis
- ✅ Interactive step-by-step UI
- ✅ Multi-tech-stack support
- ✅ Secure API key management
- ✅ Dark theme UI
📄 License
MIT License - see LICENSE file for details
🙏 Acknowledgments
📧 Support
Made with ☕ and 💻
If you find LaunchMate helpful, consider giving it a ⭐ on GitHub!
