TeaGit
AI-powered Git commit message generator for Visual Studio Code. Support for multiple state-of-the-art LLM providers with automatic staging diff analysis, custom commit styles, and secure credential storage.
🌟 Features
- ⚡ Instant Diff Analysis: Extracts and processes staged file changes automatically to construct concise, context-aware commit messages.
- 🔌 Multi-Provider LLM Engine: Supports standard integration for Gemini, Groq, and Mistral out of the box.
- 🎨 Flexible Commit Styles: Select between:
- Conventional Commits: Standardized messages with scopes (e.g.,
feat(auth): add login validation).
- Emoji Commits: Creative prefixing using modern git emojis (e.g.,
✨ add login validation).
- Basic Commits: Simple, straightforward descriptions (e.g.,
update login validation).
- ⚙️ Interactive Settings Hub: Seamless, modern Webview panel built with premium dark-mode styling, dynamic model selectors, and real-time validation.
- 🔑 Secure API Keys: Saves sensitive API credentials locally and securely using VS Code's native, encrypted
SecretStorage API.
- 🤝 Direct Source Control Integration: Populates generated messages directly into your native VS Code Git commit input field, or copies automatically to your clipboard as a fallback.
📸 Preview
Interactive Settings Hub
Configure your active AI provider, model, style, and secure credentials in our unified premium settings panel:

Native Git Integration
Easily trigger commit message generation directly from the native VS Code Source Control input area:

🚀 Getting Started
- Stage your changes in the Source Control pane (
git add).
- Run the TeaGit: Open Settings command to configure your preferred LLM provider, select a model, and save your API key securely.
- Run the TeaGit: Generate AI Commit Message command from the Command Palette or the Source Control menu to generate your commit message.
⌨️ Contribution Commands
TeaGit provides the following commands accessible via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
| Command |
Title |
Description |
Menu Location |
teagit.generateCommitMessage |
TeaGit: Generate AI Commit Message |
Analyzes staged diffs, queries the selected provider, and populates the Git input box. |
Command Palette / Source Control Title Bar |
teagit.openSettings |
TeaGit: Open Settings |
Opens the dedicated premium interactive HTML Settings Hub. |
Command Palette |
⚙️ Configuration Options
You can fine-tune TeaGit's behavior using VS Code Settings (settings.json):
| Setting Key |
Type |
Default |
Description |
teagit.provider |
string |
"Gemini" |
Active AI service provider (Gemini, Groq, Mistral). |
teagit.model |
string |
"" |
The active model ID. Leave empty to use the default model for your provider. |
teagit.commitType |
string |
"conventional" |
The style of commit message generated (basic, conventional, emoji). |
teagit.systemPrompt |
string |
"" |
Provide custom system instructions to override default rules. |
🤖 Supported Providers & Default Models
| Provider |
Default Model |
Valid Alternatives |
| Gemini |
gemini-3-flash-preview |
gemini-3-flash-lite, gemini-2.5-flash, gemini-2.5-flash-lite |
| Groq |
llama-3.3-70b-versatile |
llama-3.1-8b-instant, qwen/qwen3-32b, openai/gpt-oss-120b, moonshotai/kimi-k2-instruct |
| Mistral |
devstral-small-2507 |
mistral-small-2506, ministral-8b-2410, ministral-3b-2410 |
📄 Requirements
- Git: Must be installed on your local environment and initialized in the active workspace.
- Staged Files: You must stage files (
git add) for TeaGit to analyze the changes and generate a message.
- API Key: A valid API key for your chosen provider is required (configured securely in settings).
Enjoy clean, effortless, and professional git histories with TeaGit! ☕
| |