CommiX

AI-powered commit message generator for VS Code.
CommiX reviews your Git changes and generates clean, conventional commit messages using OpenAI / Gemini / DeepSeek models — keeping your commits consistent and effortless.

English · Report Bug · Request Feature

✨ Features

• ⚡ Generate commit messages automatically from git diff
• 🤖 Supports OpenAI / Azure OpenAI / Gemini / DeepSeek APIs
• 🌍 Supports multi-language commit messages
• 😎 Optional Gitmoji support
• 🛠️ Custom system prompt
• 📏 Follows Conventional Commits specification
• 🎨 Simple and fast UI inside the Source Control panel

📦 Installation

From VS Code Marketplace

Search for “CommiX” → Click Install

Requirements

• Node.js ≥ 16

🤯 Usage

1. Install CommiX extension in VS Code
2. Open Settings → CommiX → Configure your API key & model
3. Stage your changes (git add)
4. Click the CommiX AI button next to the commit message input
5. CommiX generates a commit message and inserts it automatically
6. Review & commit

💡 If the diff is too large, stage files in smaller batches.

⚙️ Configuration

These settings are available under:
VS Code → Settings → CommiX

📘 API Key Setup Guide — CommiX

CommiX works with OpenAI, Google Gemini, and NVIDIA NIM.
Follow this guide to generate API keys for each provider.

🟦 1. OpenAI API Key

Steps:

1. Open the OpenAI API dashboard:
   👉 https://platform.openai.com/account/api-keys
2. Sign in to your OpenAI account
3. Click “Create new secret key”
4. Copy the key
5. In VS Code:
   Settings → CommiX → OpenAI API Key

Recommended Models:

• gpt-4o
• gpt-4o-mini
• o3-mini
• o1

🟩 2. Google Gemini API Key

Steps:

1. Visit Google AI Studio:
   👉 https://aistudio.google.com/app/apikey
2. Sign in with your Google account
3. Click “Create API Key”
4. Copy the key
5. In VS Code:
   Settings → CommiX → Gemini API Key

Recommended Models:

• gemini-2.0-flash-001
• gemini-1.5-flash
• gemini-1.5-pro

🟧 3. NVIDIA NIM API Key

Steps:

1. Go to NVIDIA Build Platform:
   👉 https://build.nvidia.com
2. Sign in using your NVIDIA or Google account
3. Click API Keys in the left sidebar
4. Press “Create Key”
5. Copy the key
6. In VS Code:
   Settings → CommiX → NVIDIA API Key

Recommended Models:

• meta/llama-3.1-70b-instruct
• meta/llama-3.1-8b-instruct
• google/gemma-2-9b-it
• deepseek-r1
• deepseek-coder-v2-lite

🔒 Security Tips

• Never commit your API keys to GitHub
• Use environment variables or VS Code settings only
• Rotate keys if exposed
• Enable billing only when required

📌 Need help?

Open an issue:
👉 https://github.com/paswans05/commix/issues