GitFlow Plus for VSCode
A premium, fast, and feature-rich GitFlow workflow and AI-powered commit assistant extension for Visual Studio Code. Ported from the high-performance Tauri desktop app, it provides native GitFlow branch control and smart AI-based tooling directly within the VSCode Source Control Management (SCM) interface.
🌟 Key Features
1. Native GitFlow Branch Management
- Tree View integration: View all your
feature/, release/, and hotfix/ branches in a structured format in the Source Control panel.
- Welcome View: Quick one-click "Initialize GitFlow" button when GitFlow isn't configured in the repository yet.
- Inline Hover Actions: Finish (
check) or Delete (trash) branches instantly from the sidebar hover buttons.
- Multi-step Input Wizard: Premium, responsive input flows for initializing configurations, selecting merge strategies (merge, squash, rebase), and customizing tag choices.
- A customized icon + branch indicator next to your default Git branch (e.g.,
$(beaker) Feature: my-feature, $(package) Release: v1.0.0).
- Click the status bar item to trigger the Quick Actions Menu with contextual shortcuts.
3. AI Commit Message Generator
- Generates precise commit messages from staged changes with a single click (
sparkle button on SCM input box header).
- Integrates with major providers: OpenAI Compatible, Anthropic (Claude), Ollama (local), llama.cpp, and 9Router.
- Multiple styles: Conventional Commits, Plain, Gitmoji, and Jira tickets.
- Configurable detail levels: Ultra-minimal, Minimal, Medium, Detailed, and Comprehensive.
- Local Fallback: Automatically falls back to a rule-based generator if the AI provider is offline or unconfigured.
4. Smart Split Commit (AI)
- Dynamically analyzes complex, staged changes spanning multiple files or concerns.
- Recommends atomic commits and guides you through a multi-step checklist to commit changes in logical steps.
⚙️ Configuration Settings
Configure these in VSCode settings (settings.json):
| Setting |
Default |
Description |
gitflow-plus.ai.provider |
openai-compatible |
Select AI Provider: openai-compatible, anthropic, ollama, llamacpp, 9router. |
gitflow-plus.ai.model |
gpt-3.5-turbo |
LLM Model name. |
gitflow-plus.ai.apiUrl |
"" |
Custom endpoint URL (e.g., for self-hosted or Ollama). |
gitflow-plus.ai.tokenLimit |
2048 |
Max response token limit. |
gitflow-plus.ai.commitStyle |
conventional |
Commit format style: conventional, plain, gitmoji, jira. |
gitflow-plus.ai.detailLevel |
medium |
Length/details: ultra-minimal, minimal, medium, detailed, comprehensive. |
gitflow-plus.ai.customRules |
"" |
Custom rules or instructions to append to prompt. |
gitflow-plus.ai.rateLimitPerMinute |
10 |
Rate limiting requests per minute. Set to 0 to disable. |
🛠️ Developer Setup & Packaging
Run/Debug Locally
- Open this folder in VSCode.
- Run
pnpm install (or npm install) to install dependencies.
- Press
F5 or select Run Extension in the Debug panel.
- A new Extension Development Host window will launch containing the active extension.
Compilation Scripts
pnpm compile (or npm run compile): Build/bundle files into dist/ with esbuild.pnpm watch (or npm run watch): Watch files and rebuild on change.pnpm test (or npm run test): Run the local GitFlow integration test suite.
| |
