commit🤖ai

AI-powered Git commit messages with Gemini, OpenAI & Auto-Sync 🔄

Features

🤖

Multi-Provider

Supports Google Gemini & OpenAI GPT models

🔄

Auto-Sync Remote

Stash, pull, pop & add automatically before commit

🔀

Branch Deploy

Auto-detects active branch or creates target branch

🎨

Gitmoji Mode

Beautiful emoji-prefixed commits

📦

Conventional

Standard Conventional Commits format

💬

Context Hints

Provide hints for better AI messages

How It Works

terminal
$ commit-ai -c -s
🔄 Syncing with remote origin/main...
feat: add document parser route for large file attachments
🚀 Pushed to origin/main successfully!
$ commit-ai -s -c -b new-feature
🌱 Switching to new-feature & deploying...

Installation

bash
$ git clone https://github.com/jhowk14/commit-ai.git
$ cd commit-ai/any-linux
$ chmod +x install.sh
$ ./install.sh

The installer will guide you through configuration

bash
$ yay -S commit-ai
# Then run setup
$ commit-ai --setup

or use paru -S commit-ai

powershell
PS> git clone https://github.com/jhowk14/commit-ai.git
PS> cd commit-ai\windows
PS> .\install.ps1

The installer adds to PATH and runs interactive setup

⚙️ Configuration

Run commit-ai --setup anytime to change preferences

~/.commit-ai.conf
format=conventional
auto_confirm=false
auto_sync=true
ask_push=false
provider=gemini
model=gemini-3-flash-preview

Options

-s, -S, --sync

Auto sync remote before commit (stash, pull, pop, add)

-b, --branch

Switch or create target branch & auto-push

-c, --conv

Use Conventional Commits format

-e, --emoji

Use Gitmoji commit format

-m, --message

Provide context/hint for AI

-p, --preview

Preview message without committing

-y, --yes

Skip confirmation prompt

--setup

Interactive configuration wizard

--config

Show current configuration

-u, --undo

Undo last commit (soft reset)

-C, --custom

Use custom prompt file

--edit-prompt

Edit custom AI prompt file