commit🤖ai

AI-powered Git commit messages with Gemini & OpenAI

Features

🤖

Multi-Provider

Supports Google Gemini & OpenAI GPT models

🎨

Gitmoji Mode

Beautiful emoji-prefixed commits

📦

Conventional

Standard Conventional Commits format

💬

Context Hints

Provide hints for better AI messages

⚙️

Configurable

Persistent settings with interactive setup

🐧🪟

Cross-Platform

Works on Linux & Windows

How It Works

terminal
$ git add .
$ commit-ai
feat: add user authentication with OAuth2
$ commit-ai -e
✨ Add user authentication with OAuth2
$ commit-ai -m "fixed login bug"
fix: resolve login authentication failure
$ commit-ai --setup
🔧 Interactive configuration wizard...

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=gitmoji
auto_confirm=false
ask_push=false
use_custom_prompt=false
provider=gemini
model=gemini-3-flash-preview

Options

-s, --setup

Interactive configuration wizard

-e, --emoji

Use Gitmoji commit format

-c, --conv

Use Conventional Commits format

-m, --message

Provide context/hint for AI

-p, --preview

Preview message without committing

-y, --yes

Skip confirmation prompt

--config

Show current configuration

-u, --undo

Undo last commit (soft reset)

-C, --custom

Use custom prompt file

--edit-prompt

Edit custom AI prompt file

-h, --help

Show help message

-v, --version

Show version number