BetterCommit — AI Commit Message Generator

Generate conventional commit messages from your git diffs using AI (OpenCode Zen, OpenAI, OpenRouter, DeepSeek, Groq, Anthropic, Ollama, or local OpenCode CLI) — directly in VS Code's Source Control panel.

Forked from cihatksm/opencommit by Cihat Kösem.


Categories	SCM Providers, Other
Publisher	bcggxx
License	MIT

Resources
Repository	Source code on GitHub
Issues	Report bugs & request features
Author	bcggxx

📑 Table of Contents

✨ Features
🚀 Getting Started
⚙️ Settings
- Provider Examples
- Using Anthropic (Claude)
🔐 Security
📦 Build
📄 License

✨ Features

One-click commit messages — Sparkle icon in the Source Control panel, plus a ✨ AI Commit status bar item
Model picker — Choose from 20+ free & paid models, remembered for future use
Any AI provider — OpenCode Zen (default), OpenAI, OpenRouter, DeepSeek, Groq, Anthropic (native Messages API), Ollama, LM Studio, or local OpenCode CLI
Conventional Commits — feat:, fix:, refactor: and more
Linux kernel commits — Optional <subsystem>: <summary> format with a Signed-off-by: trailer (uses your git user.name / user.email); overrides Conventional Commits when enabled
Multi-line support — Optional body explaining WHAT and WHY
Smart diff handling — Auto-truncates large diffs to fit the API
Secure token storage — Uses VS Code SecretStorage
Regenerate — Re-generate the message if you don't like the first one

🚀 Getting Started

1. Get an API Token

Default provider is OpenCode Zen (free tier available). Choose a provider:

OpenCode Zen → https://opencode.ai/zen (includes free tier)
OpenAI → https://platform.openai.com/api-keys
OpenRouter → https://openrouter.ai/keys
Groq → https://console.groq.com/keys
DeepSeek → https://platform.deepseek.com/api_keys
Anthropic → https://console.anthropic.com/settings/keys (uses the native Messages API)
Ollama (local) → no key needed, use ollama as token

2. Configure Settings

Open VS Code Settings (Ctrl+,) and search for BetterCommit:

Setting	Default value
`Api Base Url`	`https://opencode.ai/zen/v1/chat/completions`
`Model`	`deepseek-v4-flash-free`
`Conventional Commit`	`true`

Or for local OpenCode CLI, set Api Base Url to opencode-cli.

3. Set Your Token

Open the Command Palette (Ctrl+Shift+P) and run:

BetterCommit: 🔑 Set API Token

4. Generate a Commit Message

Stage some changes in Source Control, then click the ✨ (sparkle) icon in the Source Control panel, or the ✨ AI Commit status bar item on the left status bar, OR
Run BetterCommit: ✨ Generate Commit from the Command Palette
On first use, a model picker will appear — choose your preferred model (it will be remembered)
To regenerate the message, run BetterCommit: ✨ Regenerate

⚙️ Settings

Setting	Default	Description
`commitMessageGenerator.apiBaseUrl`	`https://opencode.ai/zen/v1/chat/completions`	API endpoint URL
`commitMessageGenerator.apiProvider`	`auto`	Protocol: `auto`, `openai`, or `anthropic`
`commitMessageGenerator.model`	`deepseek-v4-flash-free`	AI model name
`commitMessageGenerator.promptModel`	`true`	Show model picker once, then remember the choice
`commitMessageGenerator.conventionalCommit`	`true`	Conventional Commit format
`commitMessageGenerator.linuxKernelCommit`	`false`	Linux kernel `<subsystem>: <summary>` format with `Signed-off-by:` (overrides conventionalCommit)
`commitMessageGenerator.multiLine`	`false`	Multi-line with body
`commitMessageGenerator.maxDiffLength`	`4000`	Max diff chars sent to API

Provider Examples

Provider	API Base URL	`apiProvider`
OpenCode Zen (default)	`https://opencode.ai/zen/v1/chat/completions`	`auto`/`openai`
OpenCode Zen Go	`https://opencode.ai/zen/go/v1/chat/completions`	`auto`/`openai`
OpenCode Zen Go (Messages API)	`https://opencode.ai/zen/go/v1/messages`	`auto`/`anthropic`
OpenAI	`https://api.openai.com/v1/chat/completions`	`auto`/`openai`
OpenRouter	`https://openrouter.ai/api/v1/chat/completions`	`auto`/`openai`
Groq	`https://api.groq.com/openai/v1/chat/completions`	`auto`/`openai`
DeepSeek	`https://api.deepseek.com/v1/chat/completions`	`auto`/`openai`
Anthropic (native)	`https://api.anthropic.com/v1/messages`	`auto`/`anthropic`
Ollama (local)	`http://localhost:11434/v1/chat/completions`	`auto`/`openai`
LM Studio (local)	`http://localhost:1234/v1/chat/completions`	`auto`/`openai`
OpenCode CLI	`opencode-cli` (runs locally)	`auto`/`openai`

Using Anthropic (Claude)

BetterCommit ships a dedicated adapter for the Anthropic Messages API so Claude models work without an OpenAI-compatible proxy. When apiProvider is auto, the adapter activates automatically whenever apiBaseUrl contains anthropic.com.

Quick setup:

Get an API key at https://console.anthropic.com/settings/keys
Run BetterCommit: Set API Token and paste the key
In Settings, set:
- Api Base Url → https://api.anthropic.com/v1/messages
- Model → e.g. claude-sonnet-4-20250514, claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, or claude-opus-4-1-20250805
(Optional) Set Api Provider to anthropic to force the Messages API regardless of URL

The adapter handles the protocol differences for you: the system prompt is moved into the top-level system field, max_tokens is sent as required, auth uses the x-api-key header (plus the mandatory anthropic-version: 2023-06-01 header), and the response is read from the content[].text block array.

🔐 Security

API tokens stored in VS Code SecretStorage (encrypted)
Tokens never logged to console
Only the diff is sent — no full file contents

📦 Build

npm install
npm run compile
npm run package

Or use the all-in-one build & install script (Windows only — it shells out to PowerShell and runs code --install-extension to install the VSIX into the local VS Code; on macOS/Linux use the three commands above, or grab the CI-built VSIX artifact from GitHub Actions):

npm run build-install          # patch bump
npm run build-install:minor    # minor bump
npm run build-install:major    # major bump

📄 License

You can (commercial or private, no need to ask):

Use, copy, modify, merge, and distribute this software — including in closed-source or commercial products
Sublicense and/or sell copies
Fork it and build your own extension on top

You must:

Keep the copyright notice and this permission notice in all copies or substantial portions of the Software

No warranty — the software is provided "AS IS", without any warranty of merchantability, fitness for a particular purpose, or non-infringement. The authors are not liable for any claim, damages, or other liability arising from its use.

Name		Name	Last commit message	Last commit date
Latest commit History 62 Commits
.github/workflows		.github/workflows
scripts		scripts
src		src
.gitignore		.gitignore
.vscodeignore		.vscodeignore
LICENSE		LICENSE
README.md		README.md
README.zh-CN.md		README.zh-CN.md
eslint.config.mjs		eslint.config.mjs
icon.png		icon.png
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Navigation Menu

Repository files navigation

BetterCommit — AI Commit Message Generator

📑 Table of Contents

✨ Features

🚀 Getting Started

1. Get an API Token

2. Configure Settings

3. Set Your Token

4. Generate a Commit Message

⚙️ Settings

Provider Examples

Using Anthropic (Claude)

🔐 Security

📦 Build

📄 License

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

BetterCommit — AI Commit Message Generator

📑 Table of Contents

✨ Features

🚀 Getting Started

1. Get an API Token

2. Configure Settings

3. Set Your Token

4. Generate a Commit Message

⚙️ Settings

Provider Examples

Using Anthropic (Claude)

🔐 Security

📦 Build

📄 License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages