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 uvx gac for contextual, well-formatted commit messages generated by large language models!
Intelligent, contextual messages that explain the why behind your changes:
uvx gac init # Configure your provider, model, and language
uvx gac # Generate and commit with LLMThat's it! Review the generated message and confirm with y.
- Anthropic • Azure OpenAI • Cerebras • ChatGPT (OAuth) • Chutes.ai
- Claude Code (OAuth) • Crof.ai • DeepSeek • Fireworks • Gemini • GitHub Copilot (OAuth)
- Groq • Kimi for Coding • LM Studio • MiniMax.io • Mistral AI • Moonshot AI
- Neuralwatt • Ollama • OpenAI • OpenCode Go • OpenRouter • Qwen Cloud (CN & INTL)
- Replicate • Streamlake/Vanchin • Synthetic.new • Together AI • Wafer.ai
- Z.AI (API & Coding Plans) • Custom Endpoints (Anthropic/OpenAI)
- 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
- 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
- DCO/Signoff (--signoff flag): Add Signed-off-by line for Developer Certificate of Origin compliance (required by Cherry Studio, Linux kernel, and other projects)
- 25+ languages: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 18+ 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
uvx 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
- Interactive feedback: Type
rto reroll,eto edit (in-place TUI by default, or your$GAC_EDITORif set), or directly type your feedback likemake it shorterorfocus 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
uvx gac -ayp(stage all, auto-confirm, push) - Git integration: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
- MCP server: Run
uvx gac serveto expose commit tools to AI agents via the Model Context Protocol
uvx gac stats # Overview: total gacs, streaks, daily/weekly peaks, top projects & models
uvx gac stats models # Per-model breakdown: gacs, tokens, latency, speed
uvx gac stats projects # Per-project breakdown: gacs, commits, tokens across all repos
uvx gac stats reset # Reset all stats (prompts for confirmation)
uvx gac stats reset model <model-id> # Reset stats for a specific model only- Track your gacs: See how many commits you've made with gac, your current streak, peak daily/weekly activity, and top projects
- Token tracking: Total prompt + completion tokens by day, week, project, and model — with high-score trophies for token usage too
- Top models: See which models you use most and how many tokens each one consumes
- High score celebrations: 🏆 trophies when you set new daily, weekly, token, or streak records; 🥈 for tying them
- Opt-in during setup:
uvx gac initasks whether to enable stats and explains exactly what's stored - Opt-out anytime: Set
GAC_DISABLE_STATS=true(or1/yes/on) to disable. Setting it tofalse/0/no(or unsetting) keeps stats enabled - Privacy-first: Stored locally in
~/.gac_stats.json. Only counts, dates, project names, and model names — no commit messages, code, or personal data. No telemetry
- 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
# Stage your changes
git add .
# Generate and commit with LLM
uvx gac
# Review → y (commit) | n (cancel) | r (reroll) | e (edit) | or type feedback| Command | Description |
|---|---|
uvx gac |
Generate commit message |
uvx gac -y |
Auto-confirm (no review needed) |
uvx gac -a |
Stage all before generating commit message |
uvx gac -S |
Interactively select files to stage |
uvx gac -o |
One-line message for trivial changes |
uvx gac -v |
Verbose format with Motivation, Technical Approach, and Impact Analysis |
uvx gac -h "hint" |
Add context for LLM (e.g., uvx gac -h "bug fix") |
uvx gac -s |
Include scope (e.g., feat(auth):) |
uvx gac -i |
Ask questions about changes for better context |
uvx gac -g |
Group changes into multiple logical commits |
uvx gac -p |
Commit and push |
uvx gac stats |
View your gac usage statistics |
# View your commit statistics
uvx gac stats
# Stats for all projects
uvx gac stats projects
# Complete workflow in one command
uvx gac -ayp -h "release preparation"
# Detailed explanation with scope
uvx gac -v -s
# Quick one-liner for small changes
uvx gac -o
# Generate commit message in a specific language
uvx gac -l ja
# Group changes into logically related commits
uvx gac -ag
# Interactive mode with verbose output for detailed explanations
uvx gac -iv
# Debug what the LLM sees
uvx gac --show-prompt
# Skip security scan (use carefully)
uvx gac --skip-secret-scan
# Add signoff for DCO compliance (Cherry Studio, Linux kernel, etc.)
uvx gac --signoffNot happy with the result? You have several options:
# Simple reroll (no feedback)
r
# Edit the commit message
e
# By default: in-place TUI with vi/emacs keybindings
# Press Esc+Enter or Ctrl+S to submit, Ctrl+C to cancel
# Set GAC_EDITOR to open your preferred editor instead:
# GAC_EDITOR=code gac → opens VS Code (--wait auto-applied)
# GAC_EDITOR=vim gac → opens vim
# GAC_EDITOR=nano gac → opens nano
# 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 againThe edit feature (e) lets you refine the commit message:
- Default (in-place TUI): Multi-line editing with vi/emacs key bindings — correct typos, adjust wording, restructure
- With
GAC_EDITOR: Opens your preferred editor (code,vim,nano, etc.) — full editor power including find/replace, macros, etc.
GUI editors like VS Code are automatically handled: gac inserts --wait so the process blocks until you close the editor tab. No extra configuration needed.
Run uvx gac init to configure your provider interactively, or set environment variables:
Need to change providers or models later without touching language settings? Use uvx 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_hereSee .gac.env.example for all available options.
Want commit messages in another language? Run uvx 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.
- 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
- ChatGPT OAuth: docs/CHATGPT_OAUTH.md - ChatGPT OAuth setup and authentication
- Custom prompts: docs/CUSTOM_SYSTEM_PROMPTS.md - Customize commit message style
- Usage statistics: See
uvx gac stats --helpor the full docs - Troubleshooting: docs/TROUBLESHOOTING.md - Common issues and solutions
- Contributing: docs/CONTRIBUTING.md - Development setup and guidelines