Generate commit messages, PR descriptions, and code reviews using free AI models via OpenRouter — directly in VS Code.
✨ Features
| Feature | Description |
|---|---|
| 🤖 AI Commit Messages | Generates Conventional Commits messages based on your staged changes |
| 📝 PR Descriptions | Creates structured PR descriptions using GitHub CLI to fetch real PR data |
| 🔍 Code Review | Analyzes your code changes and provides categorized feedback |
📦 Installation
From VS Code Marketplace (Recommended)
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X/Cmd+Shift+X) - Search for "GitFlare Assistant"
- Click Install
From VSIX File
- Download the
.vsixfile from Releases - Install via command palette:
Extensions: Install from VSIX
⚙️ Configuration
1. Get OpenRouter API Key
- Visit OpenRouter.ai
- Sign up / Log in
- Go to API Keys section
- Create a new API key
2. Configure Extension
Open VS Code Settings (Ctrl+, / Cmd+,) and search for GitFlare Assistant:
| Setting | Default | Description |
|---|---|---|
gitFlareAssistant.apiKey |
"" |
Required - Your OpenRouter API key |
gitFlareAssistant.model |
google/gemini-2.0-flash-exp:free |
AI model to use (see models) |
gitFlareAssistant.baseBranch |
main |
Base branch for PR descriptions (main or master) |
gitFlareAssistant.language |
en |
Output language: en or pt-BR |
gitFlareAssistant.useGitHubCLI |
true |
Use gh CLI for PR descriptions (requires GitHub CLI) |
Popular Free Models
| Model | Recommended For |
|---|---|
google/gemini-2.0-flash-exp:free |
General use, fast, high quality |
meta/llama-3.1-405b-instruct:free |
Complex reasoning, code review |
openai/gpt-4o-mini |
Reliable, well-balanced |
anthropic/claude-3-5-sonnet:free |
Technical accuracy |
🎯 Usage
Generate Commit Message
- Stage your changes:
git add . - Open Command Palette (
Ctrl+Shift+P/Cmd+Shift+P) - Run GitFlare: Generate Commit Message
- The generated message is inserted into the SCM input box
Tip: You can also click the ✨ icon in the Source Control panel toolbar
Generate PR Description
Prerequisites: Install and authenticate GitHub CLI (gh auth login)
- Open Command Palette
- Run GitFlare: Generate PR Description
- Enter your PR number (e.g.,
123) or full PR URL - The extension fetches PR details via
gh pr viewand the diff - AI generates a structured description in the webview panel
Fallback: If GitHub CLI isn't available, compares current branch with base branch
Review Changes
- Open Command Palette
- Run GitFlare: Review Changes
- Choose scope: Staged changes or All changes
- Review feedback appears in a webview panel with:
- 🔴 Critical Issues
- 🟡 Suggestions
- 🟢 Positive Aspects
- 📝 Summary
🖼️ Screenshots
Commit Message Generation
PR Description Generation
Code Review
🔧 Requirements
- VS Code
1.85.0or higher - OpenRouter API Key (free registration)
- GitHub CLI (optional, for PR description feature)
🐛 Troubleshooting
| Problem | Solution |
|---|---|
| "No staged changes found" | Run git add . to stage your changes |
| "API Key is required" | Configure gitAiAssistant.apiKey in settings |
| "Failed to get PR diff" | Install and authenticate GitHub CLI: gh auth login |
| "Empty content from model" | Try a different model in settings |
| "Request timed out" | Check internet connection, try a smaller diff |
How to Report Bugs
Open a bug report with:
- Extension version
- VS Code version
- Steps to reproduce
- Error messages from Output panel
🤝 Contributing
Suggest a feature • Report a bug
See CONTRIBUTING.md for development guidelines.
⚡ Quick Links
Made with ❤️ by PedroLouback