🤖 zsh-git-ai

AI-powered commit messages that actually make sense

Transform your git workflow with intelligent commit messages generated by AI. No more "fixed stuff" or "updates" - get meaningful, context-aware commit messages that follow best practices.

Demo

Just run git commit (without -m) and watch the magic happen:

$ git add .
$ git commit
⠋ Generating commit message...

Then your command line is automatically populated:

$ git commit -m "Add AI-powered commit message generation with Claude integration"

Press ENTER to commit or edit the message first. It's that simple!

Why zsh-git-ai?

🧠 Smart Context - Analyzes your actual code changes to generate relevant commit messages

⚡ Seamless Integration - Works with your existing git workflow. Just type git commit as usual

🎨 Simple & Fast - AI generates the message and populates your command line

🔧 Full Control - Press ENTER to commit or edit the message before committing

🪶 Lightweight - Single shell script, no dependencies except optional jq

Quick Start

🍺 Install with Homebrew (Recommended)

# 1. Install via Homebrew
brew tap matheusml/zsh-git-ai
brew install zsh-git-ai

# 2. Add to your shell
echo "source $(brew --prefix)/share/zsh-git-ai/zsh-git-ai.plugin.zsh" >> ~/.zshrc

# 3. Set up your API key
export ANTHROPIC_API_KEY="your-api-key-here"

# 4. Use it!
git add your-changes
git commit  # No -m needed!

Manual Installation

# 1. Clone the repository
git clone https://github.com/matheusml/zsh-git-ai ~/.zsh-git-ai
echo "source ~/.zsh-git-ai/zsh-git-ai.plugin.zsh" >> ~/.zshrc

# 2. Set up your API key
export ANTHROPIC_API_KEY="your-api-key-here"

# 3. Use it!
git add your-changes
git commit  # No -m needed!

📚 Full Installation Guide →

Documentation

• 📦 Installation & Setup - Detailed installation instructions for all package managers
• ⚙️ Configuration Guide - Customize providers, commit styles, and advanced settings
• 🤝 Contributing - Help make zsh-git-ai better!