AI-powered git automation: smart commits, conflict resolution, and auto-rebase. Pure Bash.

• AI commit messages — Generate meaningful commit messages from your staged diff (title only by default, optional bullet points with --bullets)
• Multi-provider — Claude Code & Codex (CLI), Anthropic, OpenAI, Gemini & Mistral (API)
• CLI-first — Uses claude and codex CLIs directly — no API key needed for those
• Budget-friendly defaults — Uses cheap/mini models by default (haiku, gpt-5-mini, gemini-2.5-flash-lite, mistral-small-latest)
• Smart diff truncation — Prioritizes small file diffs to maximize info sent to the AI (16K chars budget)
• Conflict resolution — AI-powered merge conflict resolution
• Auto-rebase — pull --rebase with automatic conflict resolution
• Conventional Commits — Optional formatting with --conventional
• Emoji support — Add emoji to commit messages with --emoji
• Multi-language — Generate commit messages in any language
• Dry run — Preview commit messages without committing
• Pure Bash — Single script, no heavy runtime dependencies

brew install maxgfr/tap/git-pilot

curl -fsSL https://raw.githubusercontent.com/maxgfr/git-pilot/main/script.sh -o git-pilot
chmod +x git-pilot
sudo mv git-pilot /usr/local/bin/

For CLI providers (no API key needed):

• Claude Code: Install Claude Code (claude CLI)
• Codex: Install OpenAI Codex (codex CLI)

For API providers:

• curl and jq (installed automatically if missing)
• An API key for the chosen provider

# 1. Configure your provider
git-pilot setup

# 2. Stage your changes and generate a commit
git add .
git-pilot

With Claude Code (default), no API key is needed — just have claude installed.

git-pilot [command] [options]

# Basic commit with Claude Code (default, uses haiku)
git add .
git-pilot

# Auto-stage + conventional commits + emoji
git-pilot -a -c -e

# Force a conventional commit type
git-pilot fix
git-pilot feat -B    # 'feat' type, with bullet points

# Dry run (preview only)
git-pilot -d

# Use Codex CLI
git-pilot -p codex

# Use Anthropic API
git-pilot -p anthropic

# Use OpenAI API with a specific model
git-pilot -p openai -m gpt-5-mini

# Commit in French
git-pilot -l fr

# Resolve merge conflicts with AI
git-pilot resolve

# Pull --rebase with AI conflict resolution
git-pilot rebase

# Show current config
git-pilot config

# Non-interactive mode (auto-stage + skip confirm + push)
git-pilot -a -y -P

Configuration is stored at ~/.config/git-pilot/config (XDG-compliant) with chmod 600 to protect your API key.

# git-pilot configuration
provider=claude-code
api_key=
model=haiku
max_tokens=1024
auto_stage=false
auto_push=false
language=en
conventional=true
emoji=false
bullets=false
skip_confirm=false

You can view your active configuration at any time with git-pilot config.

API keys can be provided via environment variables (fallback for API providers):

CLI providers (claude-code, codex) don't need API keys — they use their own authentication.

All default models are cheap/mini models — more than enough for generating commit messages.

MIT

Inspired by claude-auto-commit.