gac 3.14.1

LLM-powered Git commit message generator with multi-provider support

🚀 Git Auto Commit (gac)

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | हिन्दी | Tiếng Việt | Français | Русский | Español | Português | Norsk | Svenska | Deutsch | Nederlands | Italiano

LLM-powered commit messages that understand your code!

Automate your commits! Replace git commit -m "..." with gac for contextual, well-formatted commit messages generated by large language models!

---

What You Get

Intelligent, contextual messages that explain the why behind your changes:

---

Quick Start

Use gac without installing

uvx gac init   # Configure your provider, model, and language
uvx gac  # Generate and commit with LLM

That's it! Review the generated message and confirm with y.

Install and use gac

uv tool install gac
gac init
gac

Upgrade installed gac

uv tool upgrade gac

---

Key Features

🌐 25+ Supported Providers

• Anthropic • Azure OpenAI • Cerebras • Chutes.ai • Claude Code (OAuth)
• DeepSeek • Fireworks • Gemini • Groq • Kimi for Coding • LM Studio
• MiniMax.io • Mistral AI • Moonshot AI • Ollama • OpenAI • OpenRouter
• Qwen.ai (OAuth) • Replicate • Streamlake • Synthetic.new • Together AI
• Z.AI • Z.AI Coding • Custom Endpoints (Anthropic/OpenAI)

🧠 Smart LLM Analysis

• Understands intent: Analyzes code structure, logic, and patterns to understand the "why" behind your changes, not just what changed
• Semantic awareness: Recognizes refactoring, bug fixes, features, and breaking changes to generate contextually appropriate messages
• Intelligent filtering: Prioritizes meaningful changes while ignoring generated files, dependencies, and artifacts
• Intelligent commit grouping - Automatically group related changes into multiple logical commits with --group

📝 Multiple Message Formats

• One-liner (-o flag): Single-line commit message following conventional commit format
• Standard (default): Summary with bullet points explaining implementation details
• Verbose (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
• 50/72 rule (--50-72 flag): Enforce the classic commit message format for optimal readability in git log and GitHub UI

🌍 Multilingual Support

• 25+ languages: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 20+ more languages
• Flexible translation: Choose to keep conventional commit prefixes in English for tool compatibility, or fully translate them
• Multiple workflows: Set a default language with gac language, or use -l <language> flag for one-time overrides
• Native script support: Full support for non-Latin scripts including CJK, Cyrillic, Thai, and more

💻 Developer Experience

• Interactive feedback: Type r to reroll, e to edit in-place with vi/emacs keybindings, or directly type your feedback like make it shorter or focus on the bug fix
• Interactive questioning: Use --interactive (-i) to answer targeted questions about your changes for more contextual commit messages
• One-command workflows: Complete workflows with flags like gac -ayp (stage all, auto-confirm, push)
• Git integration: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
• MCP server: Run gac serve to expose commit tools to AI agents via the Model Context Protocol

🛡️ Built-in Security

• Automatic secret detection: Scans for API keys, passwords, and tokens before committing
• Interactive protection: Prompts before committing potentially sensitive data with clear remediation options
• Smart filtering: Ignores example files, template files, and placeholder text to reduce false positives

---

Usage Examples

Basic Workflow

# Stage your changes
git add .

# Generate and commit with LLM
gac

# Review → y (commit) | n (cancel) | r (reroll) | e (edit) | or type feedback

Common Commands

Command	Description
gac	Generate commit message
gac -y	Auto-confirm (no review needed)
gac -a	Stage all before generating commit message
gac -o	One-line message for trivial changes
gac -v	Verbose format with Motivation, Technical Approach, and Impact Analysis
gac -h "hint"	Add context for LLM (e.g., gac -h "bug fix")
gac -s	Include scope (e.g., feat(auth):)
gac -i	Ask questions about changes for better context
gac -g	Group changes into multiple logical commits
gac -p	Commit and push

Power User Examples

# Complete workflow in one command
gac -ayp -h "release preparation"

# Detailed explanation with scope
gac -v -s

# Quick one-liner for small changes
gac -o

# Group changes into logically related commits
gac -ag

# Interactive mode with verbose output for detailed explanations
gac -iv

# Debug what the LLM sees
gac --show-prompt

# Skip security scan (use carefully)
gac --skip-secret-scan

Interactive Feedback System

Not happy with the result? You have several options:

# Simple reroll (no feedback)
r

# Edit in-place with rich terminal editing
e
# Uses prompt_toolkit for multi-line editing with vi/emacs keybindings
# Press Esc+Enter or Ctrl+S to submit, Ctrl+C to cancel

# Or just type your feedback directly!
make it shorter and focus on the performance improvement
use conventional commit format with scope
explain the security implications

# Press Enter on empty input to see the prompt again

The edit feature (e) provides rich in-place terminal editing, allowing you to:

• Edit naturally: Multi-line editing with familiar vi/emacs key bindings
• Make quick fixes: Correct typos, adjust wording, or refine formatting
• Add details: Include information the LLM might have missed
• Restructure: Reorganize bullet points or change the message structure

---

Configuration

Run gac init to configure your provider interactively, or set environment variables:

Need to change providers or models later without touching language settings? Use gac model for a streamlined flow that skips the language prompts.

# Example configuration
GAC_MODEL=anthropic:your-model-name
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here

See .gac.env.example for all available options.

Want commit messages in another language? Run gac language to select from 25+ languages including Español, Français, 日本語, and more.

Want to customize commit message style? See docs/CUSTOM_SYSTEM_PROMPTS.md for guidance on writing custom system prompts.

---

Project Analytics

📊 View live usage analytics and statistics →

Track real-time installation metrics and package download statistics.

---

Getting Help

• Full documentation: docs/USAGE.md - Complete CLI reference
• MCP server: docs/MCP.md - Use GAC as an MCP server for AI agents
• Claude Code OAuth: docs/CLAUDE_CODE.md - Claude Code setup and authentication
• Qwen.ai OAuth: docs/QWEN.md - Qwen.ai setup and authentication
• Custom prompts: docs/CUSTOM_SYSTEM_PROMPTS.md - Customize commit message style
• Troubleshooting: docs/TROUBLESHOOTING.md - Common issues and solutions
• Contributing: docs/CONTRIBUTING.md - Development setup and guidelines

---

Made with ❤️ for developers who want better commit messages

⭐ Star us on GitHub • 🐛 Report issues • 📖 Full docs