Home Original page

GitHub - mizuikk/ai-commit-plus: Use OpenAI / Azure OpenAI / DeepSeek / Gemini API to review Git changes, generate conventional commit messages that meet the conventions, simplify the commit process, and keep the commit conventions consistent.

AI Commit Plus logo

Use OpenAI / Azure OpenAI / DeepSeek / Gemini APIs to review staged Git changes, generate conventional commit messages, and keep commit conventions consistent across repositories.

This project is a fork of Sitoi/ai-commit, with independent branding, release workflow, and repository-level language override improvements.

English · 简体中文 · Report Bug · Request Feature

Features

  • Generate commit messages from staged diffs with OpenAI / Azure OpenAI / DeepSeek / Gemini.
  • Support multi-language commit messages.
  • Support repository-level language overrides for multi-project workflows.
  • Support Gitmoji prompts.
  • Support custom system prompts.
  • Support Conventional Commits.

Installation

  1. Download the latest .vsix asset from GitHub Releases.
  2. In VS Code, run Extensions: Install from VSIX....
  3. Select the downloaded ai-commit-plus-<version>.vsix package.

Note
Use Node.js 24.14.1 or later for local development and packaging.

Usage

  1. Install and enable AI Commit Plus.
  2. In VS Code settings, configure the ai-commit-plus settings namespace.
  3. Stage the changes you want to include in the commit.
  4. Optional: enter extra context in the Source Control message box before generating the commit message.
  5. Click the AI Commit Plus action in the Source Control title area.
  6. Review the generated message and commit if it looks correct.

If you switch between repositories that require different commit languages, press Ctrl+Shift+P to open the Command Palette (Cmd+Shift+P on macOS), then run Set Commit Language for Current Repository. It stores a workspace or folder override only for the active repository.

Note
This command saves the language choice as a VS Code workspace or folder setting. In a single-folder repository, it will usually write to .vscode/settings.json; if that file is tracked by Git, you may see it in your changes list.

Note
If your diff is too large for the configured model context window, stage and generate the commit in smaller batches.

Configuration

Note
Since 0.0.5, EMOJI_ENABLED and FULL_GITMOJI_SPEC are no longer required. The default Gitmoji prompt is prompt/with_gitmoji.md. If you do not want Gitmoji output, set AI_COMMIT_SYSTEM_PROMPT to your own prompt and start from prompt/without_gitmoji.md.

All settings live under the ai-commit-plus. prefix in VS Code:

Setting Type Default Required Notes
AI_PROVIDER string openai Yes Supported values: openai, gemini
OPENAI_API_KEY string None Yes* Required when AI_PROVIDER is openai
OPENAI_BASE_URL string None No For Azure, use https://{resource}.openai.azure.com/openai/deployments/{model}
OPENAI_MODEL string gpt-4o Yes* You can update it with Show Available OpenAI Models
AZURE_API_VERSION string None No Azure OpenAI API version
OPENAI_TEMPERATURE number 0.7 No Valid range: 0 to 2
GEMINI_API_KEY string None Yes* Required when AI_PROVIDER is gemini
GEMINI_MODEL string gemini-2.0-flash-001 Yes* Gemini model name
GEMINI_TEMPERATURE number 0.7 No Valid range: 0 to 2
AI_COMMIT_LANGUAGE string English Yes Supports 19 languages and repository-level overrides
AI_COMMIT_SYSTEM_PROMPT string None No Custom system prompt for commit generation

Local Development

You can develop online with GitHub Codespaces:

Or clone the repository locally:

git clone https://github.com/mizuikk/ai-commit.git
cd ai-commit
npm install

Open the project in VS Code and press F5 to launch an Extension Development Host.

Contributing

Issues and pull requests are welcome. Use GitHub Issues for bugs, feature requests, and discussion.

Contributors

Credits

License

This project is MIT licensed.