Spreadle AI Commit Writer

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.
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.

Spreadle AI Commit Writer generating a commit message

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 generated message, 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.

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+P or Cmd+Shift+P.
Run AI Commit Gen: Set API Key.
Choose your provider.
Paste the API key when prompted.

Setting an API key for the selected AI provider

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+P or Cmd+Shift+P.
Run AI Commit Gen: Switch Provider.
Choose OpenAI, Anthropic Claude, Google Gemini, Groq, or z.ai.

Switching the active AI provider

To change the exact model used by a provider, open VS Code Settings and search for AI Commit Gen. Update the matching setting, such as aiCommitGen.openai.model, aiCommitGen.anthropic.model, or aiCommitGen.gemini.model.

Commands

AI Commit Gen: Generate Message
AI Commit Gen: Switch Provider
AI Commit Gen: Set API Key

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.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`	`llama-3.3-70b-versatile`	Groq model.
`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

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.1.1.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.