Git Ai

git-ai

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.

[](https://github.com/git-extensions/git-ai/actions/workflows/ci.yml) [](https://github.com/git-extensions/git-ai/releases/latest) [](LICENSE)

git add -p && git ai commit

Requirements

• 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

Installation

Nix (recommended)

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

Zsh Plugin

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

Manual (symlink)

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