Spreadle AI Commit Writer writes Conventional Commit messages from your Git changes directly inside VS Code's Source Control view.
Features
- Generate commit messages from the Source Control toolbar.
- Fill the Git commit message input automatically.
- Preview each message and Apply, Edit, Regenerate, or Copy it before it lands in the commit input.
- Pick a model per provider from the Command Palette.
- Auto-stage unstaged and untracked changes when nothing is staged.
- Show a loading state while the provider is generating.
- Switch between OpenAI, Anthropic Claude, Google Gemini, Groq, and z.ai.
- Store API keys securely with VS Code Secret Storage.
Usage
- Open a Git repository in VS Code.
- Make a change in your project.
- Open Source Control.
- Click the Spreadle AI Commit Writer button in the Source Control toolbar.
- If prompted, choose a provider and set its API key.
- Review the preview, choose Apply, Edit, Regenerate, or Copy, then commit.
If files are already staged, Spreadle AI Commit Writer generates from the staged diff only. If nothing is staged and aiCommitGen.autoStage is enabled, it stages all current changes first. In multi-folder workspaces the active repository is detected automatically.
Set Your API Key
The first time you generate a commit message, Spreadle AI Commit Writer asks which provider to use and prompts for that provider's API key. You can also set or replace a key at any time from the Command Palette.
- Open the Command Palette with
Ctrl+Shift+PorCmd+Shift+P. - Run
AI Commit Gen: Set API Key. - Choose your provider.
- Paste the API key when prompted.
API keys are saved in VS Code Secret Storage. They are not written to your repository.
Change Provider or Model
Use the Command Palette when you want to switch providers without editing settings manually.
- Open the Command Palette with
Ctrl+Shift+PorCmd+Shift+P. - Run
AI Commit Gen: Switch Provider. - Choose OpenAI, Anthropic Claude, Google Gemini, Groq, or z.ai.
To change the exact model used by a provider, run AI Commit Gen: Change Model from the Command Palette and pick from the provider's curated model list (or enter a custom model name). You can also edit the settings directly, such as aiCommitGen.openai.model, aiCommitGen.anthropic.model, or aiCommitGen.gemini.model.
Commands
AI Commit Gen: Generate MessageAI Commit Gen: Switch ProviderAI Commit Gen: Set API KeyAI Commit Gen: Change Model
Settings
| Setting | Default | Description |
|---|---|---|
aiCommitGen.provider |
openai |
AI provider used for generation. |
aiCommitGen.autoStage |
true |
Stage all changes before generation when nothing is staged. |
aiCommitGen.previewCommit |
true |
Preview the generated message (Apply/Edit/Regenerate/Copy) before filling the commit input. |
aiCommitGen.maxDiffSize |
10000 |
Maximum diff size sent to the provider. |
aiCommitGen.openai.model |
gpt-4o-mini |
OpenAI model. |
aiCommitGen.anthropic.model |
claude-sonnet-4-20250514 |
Anthropic model. |
aiCommitGen.gemini.model |
gemini-2.0-flash |
Gemini model. |
aiCommitGen.groq.model |
openai/gpt-oss-120b |
Groq model. |
aiCommitGen.groq.fallbackModel |
qwen/qwen3.6-27b |
Fallback Groq model used when the primary model is unavailable. |
aiCommitGen.zai.model |
glm-4-flash |
z.ai model. |
Privacy
AI Commit Gen sends the selected Git diff to the configured AI provider. API keys are stored in VS Code Secret Storage and are not written to repository files.
Review generated messages before committing. Disable aiCommitGen.autoStage if you want to manually control exactly which files are included.
Local Development
npm install
npm run compile
npm test
npm run lint
Press F5 in VS Code to launch an Extension Development Host.
Package Locally
npm run package
Install the generated VSIX:
code --install-extension spreadle-ai-commit-gen-0.2.0.vsix
Publish
Create or verify the spreadle publisher in the Visual Studio Marketplace, then run:
npx vsce login spreadle
npx vsce publish
The extension is bundled with esbuild before packaging and publishing.