Universal Commit Assistant

VS Code Marketplace | Rate & Review | Report Issues

Stop writing commit messages manually. Let AI generate perfect commit messages for you instantly, with support for 9 AI providers and 8 languages, directly in VS Code.

Why Universal Commit Assistant?

• Save Time: Generate commit messages in seconds instead of minutes
• Always Consistent: Follow conventional commit standards automatically
• Your Language: Support for 8 languages including English, Chinese, Spanish, French, Russian, Japanese, Korean, Vietnamese
• Privacy First: Use local AI models (Ollama, LM Studio) or secure cloud providers

Quick Start

1. Install - Search "Universal Commit Assistant" in VS Code Extensions
2. Configure - Choose your AI provider and add API key (or setup local model)
3. Generate - Click the sparkle button in Source Control panel

That's it! Your commit messages will be professionally written and consistent.

Smart Commit Generation

• Context-Aware: Analyzes your actual code changes to understand what you did
• Multiple Styles: Choose from conventional commits, concise format, or detailed explanations
• Deep Analysis: Provides statistical insights (files changed, insertions, deletions, file types)
• First Commit Detection: Automatically generates appropriate initial commit messages
• Smart Truncation: Intelligently handles large diffs while preserving important context
• Flexible Context: Works with staged changes, unstaged changes, or both
• Customizable: Adjust AI creativity, message length, and add custom prompts

AI Provider Options

Choose the provider that fits your needs and budget:

Cloud Providers (API Key Required)

Local Providers (Privacy First)

Configuration

Access via Settings > Extensions > Universal Commit Assistant:

Essential Settings

• Provider: Select your preferred AI service
• Message Style:
  • conventional - feat: add new feature
  • concise - add new feature
  • detailed - Multi-line with explanations
  • custom - Your own template
• Language: Choose from 8 supported languages
• Include Unstaged: Analyze uncommitted changes too

AI Behavior

• Temperature: Control creativity (0 = consistent, 2 = creative)
• Max Tokens: Message length limit (100-500)
• Max Diff Length: Maximum characters of git diff to send to AI (1000-10000, default: 3000)
• Detect First Commit: Automatically detect and generate appropriate initial commit messages (default: enabled)
• Custom Prompt: Override default instructions

Example Outputs

Conventional Style:

feat: add user authentication with JWT tokens

Implement secure login system with password hashing and session management

Detailed Style:

feat: implement user authentication system

This commit introduces a comprehensive authentication system for the application.

**Key Changes:**
- Added JWT token-based authentication
- Implemented password hashing with bcrypt
- Created user session management
- Added login/logout endpoints

**Benefits:**
- Improves application security
- Enables user-specific features
- Follows industry best practices

Commands

Access these via Command Palette (Ctrl+Shift+P):

• Generate Universal Commit Message - Main functionality
• Show API Key Status - Check which providers are configured
• Clear All API Keys - Remove stored credentials
• Open Settings - Quick access to configuration

Multi-Language Support

Generate commit messages in your preferred language:

• English (default)
• Chinese (Simplified)
• Spanish
• French
• Russian
• Japanese
• Korean
• Vietnamese

Token Cost Analysis

Universal Commit Assistant is designed to be cost-effective while providing high-quality commit messages.

Typical Token Usage

Standard Analysis (current baseline):

• ~1,000-2,300 tokens per commit
• Includes: file list, basic diff (2000 chars), prompts

Enhanced Analysis (with deep features):

• ~1,800-3,200 tokens per commit
• Includes: file list, statistics, enhanced diff (3000 chars), file categorization

Cost per Commit by Provider

Based on enhanced analysis (~2,500 input tokens + 150 output tokens average):

Cost Optimization Tips

1. Use Cost-Effective Providers: Gemini 3 Pro, DeepSeek, Qwen, and GPT-5.1 offer excellent quality at low cost
2. Adjust Max Diff Length: Reduce maxDiffLength to 2000 for simpler commits
3. Local Models: Use Ollama or LM Studio for completely free operation
4. Smart Defaults: The extension uses intelligent truncation to minimize tokens while preserving context

Bottom Line: Even with premium models, most users spend less than $1/month on commit message generation.

Requirements

• VS Code: Version 1.95.0 or higher
• Git Repository: With changes to commit
• AI Provider: API key (cloud) or running server (local)

Privacy & Security

• Secure Storage: API keys stored in VS Code's encrypted secret storage
• No Data Retention: Your code never leaves your machine with local providers
• Optional Analytics: Usage tracking can be disabled (no sensitive data collected)
• Open Source: Full transparency with MIT license

Need Help?

• Documentation: See configuration examples above
• Issues: Report bugs on GitHub
• Feature Requests: Suggest improvements
• Rate & Review: Help others discover this extension

License

MIT License - see LICENSE file for details.

Made for developers who value their time

Save hours every week on commit messages. Install now and never write another commit message manually.