CommitHub

AI-powered Git commit message generator for VS Code

Generate conventional commit messages from all working-tree changes with a single click. Supports 12 AI provider configurations, automatic model selection, Conventional Commits, emoji, and 32 languages.

Features

• One-click commit — SCM title bar button generates a commit message from your git diff
• Writes to SCM input box — the generated message appears directly in Source Control's input field; review, edit, then commit manually
• 12 provider configurations — OpenAI, Anthropic, Gemini, Zhipu GLM, xAI, DeepSeek, Mistral, Ollama, OpenRouter, Groq, Together AI, and Zhipu Coding Plan
• Model profiles — Fast, Balanced, and Quality automatically select an appropriate discovered model; Manual preserves an explicit choice
• Conventional Commits — feat:, fix:, docs:, chore: and more with a fully customizable type list
• Emoji support — relevant emoji prefix on commit messages
• 32 languages — generate messages in Turkish, English, German, French, Japanese, Chinese, and more
• Scope Detection — auto-detects scope from changed file paths (feat(api):, fix(auth):)
• Tone selection — formal, casual, or technical
• Breaking Changes — auto-detects breaking API changes and adds BREAKING CHANGE: footer
• Prerequisite system — warns when required settings are missing and guides you to the right place
• Connection status — status bar shows ✓ CommitHub with live connection state
• Persistent statistics — token usage, API call counts survive across sessions
• Debug channel — dedicated Output Channel records request diagnostics, timing, and token metadata
• Model discovery — fetches, filters, ranks, and temporarily caches models from the provider API
• Custom Base URL — supports any OpenAI-compatible endpoint
• Cancellable — progress notification with Cancel button for long-running requests
• Complete Git changes — staged, unstaged, deleted, renamed, and untracked files are included
• Repository-aware — multi-root and nested workspaces write the result to the matching SCM input
• Auto-start — activates on VS Code startup, status bar ready immediately

Getting Started

1. Install from VS Code Marketplace
2. Open the CommitHub panel in the Activity Bar
3. Set your API Key (Settings → API Key)
4. Choose your Provider (Settings → Provider)
5. Click the Generate button (💀) in the Source Control title bar
6. Review the message in the SCM input box, then Ctrl+Enter to commit

Configuration

All settings are accessible from the CommitHub panel in the Activity Bar, organized into three groups:

Provider

Message

Analysis

Supported Providers

Notes

• Ollama: No API key required — runs locally
• DeepSeek: Quality enables thinking with high reasoning effort; Fast and Balanced disable thinking for lower latency
• API keys are retained independently when switching providers

Commands

Development

# Install dependencies
npm install

# Build (webpack → dist/extension.js)
npm run compile

# Watch mode
npm run watch

# Launch Extension Development Host (F5 in VS Code)

# Test
npm test

# Lint
npm run lint

# Package for publishing
npm run package

Architecture

src/
├── extension.ts          # Entry point, all command registrations
├── state.ts              # Global state (connection, stats, persistence)
├── services/
│   ├── git.ts            # Repository-aware, bounded Git diff reader
│   ├── ai.ts             # Prompt and streaming orchestration
│   ├── httpClient.ts     # Cancellable Node HTTP transport
│   ├── modelDiscovery.ts # Model discovery, ranking, profiles, cache
│   ├── providers.ts      # Provider registry and defaults
│   └── adapters/         # OpenAI, Anthropic, Gemini, DeepSeek protocols
└── views/
	└── settingsView.ts   # Tree Data Provider

• Dual compiler: Extension built with webpack, tests with tsc
• vscode, https, http, child_process, fs are externalized in webpack config
• API keys stored per provider in SecretStorage (never written to settings.json)
• Statistics persisted in context.globalState across sessions
• API calls use Node.js https/http modules (including local Ollama endpoints)
• HTTP requests are cancellable via AbortController wired to VS Code CancellationToken

Git diff safety

• Uses git diff HEAD so staged and unstaged changes are analyzed together.
• Uses Git's empty tree before the first commit, including post-stage working-tree edits.
• Reads Unicode and renamed paths from NUL-delimited Git metadata.
• Always excludes lockfiles, build output, images, archives, and minified bundles.
• Caps each untracked file at 100 lines and 256 KB; binary and symlink targets are omitted.
• Falls back to a file summary when the tracked patch exceeds the 10 MB collection limit.

License

MIT