LLM-powered commit messages that understand your code.

Tired of writing commit messages? Replace git commit -m "..." with gac for contextual, well-formatted commit messages generated by large language models.

Instead of generic messages like "update stuff", "fix bug", or "add feature", you get intelligent, contextual messages that explain the why behind your changes:

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

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

uv tool install gac
gac init
gac

• Anthropic • Cerebras • Chutes.ai • Gemini • Groq
• LM Studio • Ollama • OpenAI • OpenRouter
• Streamlake • Synthetic.new • Z.AI • Z.AI Coding

• 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

• 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

• Interactive feedback: Regenerate messages with specific requests like r "make it shorter" or r "focus on the bug fix"
• 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

• 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
gac

# Review → y (commit) | n (cancel) | r (reroll)

# 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

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

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

Not happy with the result? Use the reroll feature for intelligent regeneration:

# Simple regeneration (uses previous context)
r

# With specific feedback
r make it shorter and focus on the performance improvement
r use conventional commit format with scope
r explain the security implications

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

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

• Full documentation: USAGE.md - Complete CLI reference
• Troubleshooting: TROUBLESHOOTING.md - Common issues and solutions
• Contributing: CONTRIBUTING.md - Development setup and guidelines