Stop writing commit messages by hand. git-ai generates precise, conventional commit messages from your staged changes — powered by Claude, Codex, or Gemini, right in your terminal.

git add -p && git ai commit

• Bash 4.4+ (bash)
• One supported AI agent:
  • Claude Code (claude)
  • Codex (codex)
  • Gemini CLI (gemini)
• jq for Gemini output parsing
• Gum (gum)

macOS (Homebrew):

brew install bash gum

Nix:

nix profile install nixpkgs#bash nixpkgs#gum

Install your AI agent separately:

• Claude Code: Claude Code installation guide
• Codex: OpenAI Codex
• Gemini CLI: google-gemini/gemini-cli

Run directly without installing:

nix run github:git-extensions/git-ai -- commit

Or install into your profile:

nix profile install github:git-extensions/git-ai

The plugin adds git-ai to your $PATH so git discovers it as a custom command (git ai).

Note: Bash 4.4+ is still required. On macOS: brew install bash.

zinit light git-extensions/git-ai

Symlink the git-ai script onto your $PATH so git discovers it as a custom command:

ln -s /path/to/git-extensions/git-ai/git-ai /usr/local/bin/git-ai

Then use it as git ai <command>.

git ai commit [-d <DESCRIPTION>] [GIT_COMMIT_OPTIONS]

Generates a conventional commit message from your staged changes. Use -d/--description to provide extra context or constraints that guide the AI when writing the message.

git add -p
git ai commit
git ai commit -d "focus on the security improvements"
git ai commit --signoff
git ai commit --no-verify

Override the AI provider and model via git config.

Agent defaults:

Per-command keys take priority over ai.model.

# Set the default model
git config --global ai.model haiku

# Use a stronger model for commits
git config --global ai.commit.model sonnet

# Use Codex
git config --global ai.agent codex
git config --global ai.model gpt-5.4-mini

# Use Gemini
git config --global ai.agent gemini
git config --global ai.model gemini-2.5-flash

MIT — Copyright (c) 2025 git-extensions