Git Commit AI Helper

AI-powered VS Code extension that analyzes your staged changes and generates conventional commit messages — with optional code review before you commit.

Features

• 🤖 AI Commit Generation — Analyze git diff --cached and auto-generate type(scope): subject format following your project's convention
• 📋 One-Click Fill — Auto-fills VS Code SCM input box, no copy-paste needed
• 🔧 Project Convention Aware — Reads .gitmessage, commitlint.config.js, or custom .gitcommithelper.json
• 🔌 Multi-Provider — Supports OpenAI, DeepSeek, and custom OpenAI-compatible endpoints
• ⚡ Keyboard Shortcut — Ctrl+Shift+C (Windows/Linux) / Cmd+Shift+C (Mac) in SCM view
• 📊 Status Bar — Quick access from the status bar
• 🔒 Privacy-First — Your code never leaves your machine when using your own API key

Quick Start

1. Install the extension from VS Code Marketplace
2. Open a Git repository with staged changes
3. Generate — Click the "Generate Commit Message" button in Source Control title bar, or press Ctrl+Shift+C
4. Enter API Key when prompted (stored securely in VS Code SecretStorage)
5. Commit — Review the generated message and commit!

Configuration

Supported Providers

Convention Config Priority

The extension automatically detects your project's commit convention in this order:

1. .gitcommithelper.json — Custom config file (project root)
2. .gitmessage — Git commit template file
3. commitlint.config.js — Commitlint configuration
4. Conventional Commits spec — Default fallback

.gitcommithelper.json Example

{
  "types": ["feat", "fix", "docs", "refactor", "test", "chore"],
  "scopes": ["api", "web", "core", "cli"],
  "subjectMaxLength": 72,
  "allowBreakingChanges": true
}

Commands

Architecture

VS Code Extension (TypeScript)
├── src/git.ts          — Git diff parsing
├── src/config.ts       — Convention detection
├── src/llm.ts          — LLM provider abstraction
├── src/commit-gen.ts   — Commit generation logic
└── src/extension.ts    — VS Code entry point

License

MIT © AnsonCar