Quick Start

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.

Key Features

33+ Supported Providers

• Anthropic • Azure OpenAI • Cerebras • ChatGPT (OAuth) • Chutes.ai • Claude Code (OAuth)
• Crof.ai • DeepInfra • DeepSeek • Fireworks • Gemini • GitHub Copilot (OAuth) • Groq
• Kimi for Coding • Lilac • LM Studio • MiniMax.io • Mistral AI • Moonshot AI • Neuralwatt • Ollama
• Ollama Cloud • OpenAI • OpenCode Go • OpenRouter • Plexus Gateway • Qwen Cloud (CN & INTL)
• Replicate • Streamlake/Vanchin • Synthetic.new • Together AI • Wafer.ai • Z.AI (API & Coding Plans)
• 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
• DCO/Signoff (--signoff flag): Add Signed-off-by line for Developer Certificate of Origin compliance (required by Cherry Studio, Linux kernel, and other projects)

🌍 Multilingual Support

• 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

💻 Developer Experience

• Interactive feedback: Type r to reroll, e to edit (in-place TUI by default, or your $GAC_EDITOR if set), 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 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 serve to expose commit tools to AI agents via the Model Context Protocol

📊 Usage Statistics

uvx gac stats               # Overview: total gacs, streaks, daily/weekly peaks, top projects & models
uvx gac stats models        # Per-model breakdown: gacs, tokens, latency, speed, per-commit latency charts
uvx gac stats projects      # Per-project breakdown: gacs, commits, tokens, avg files per gac across all repos
uvx gac stats recent        # Recent gac history: per-gac tokens, speed, latency, files (-n 20 for more)
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 init asks whether to enable stats and explains exactly what's stored
• Opt-out anytime: Set GACDISABLESTATS=true (or 1/yes/on) to disable. Setting it to false/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

🛡️ 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
uvx gac
Review → y (commit) | n (cancel) | r (reroll) | e (edit) | or type feedback

Common Commands

| 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 model | Change AI provider and model | | uvx gac stats | View your gac usage statistics |

Power User Examples

# 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 --signoff

Interactive Feedback System

Not happy with the result? You have several options:

# Simple reroll (no feedback)
r
Edit the commit message
e
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) 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.

Configuration

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.

See .gac.env.example for all available options, including GACALWAYSGROUPED to always use grouped commit mode, GACALWAYSINCLUDE_SCOPE to auto-infer commit scopes, and many others for customization.

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/CUSTOMSYSTEM_PROMPTS.md for guidance on writing custom system prompts.

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
• ChatGPT OAuth: docs/CHATGPT_OAUTH.md - ChatGPT OAuth setup and authentication
• Custom prompts: docs/CUSTOMSYSTEM_PROMPTS.md - Customize commit message style
• Usage statistics: See uvx gac stats --help or the full docs
• Troubleshooting: docs/TROUBLESHOOTING.md - Common issues and solutions
• Contributing: docs/CONTRIBUTING.md - Development setup and guidelines