commitai-cli 0.2.0

Local AI-powered git commit message generator using Ollama

commitai

Local AI-powered git commit message generator using Ollama. Zero API cost, fully local.

Requirements

• Python 3.12+
• Ollama running locally with a model pulled (e.g. llama3.2:3b)

Installation

pip install commitai

Usage

# Stage your changes first
git add .

# Generate commit message → confirm → commit
commit

# Generate commit message → confirm → commit → push
commit /deploy

At the prompt you can:

• Y or Enter — accept and commit
• n — abort
• e — open your $EDITOR to edit the message before committing

Configuration

Create a .commitrc file in your repo root to override defaults:

model = "llama3.2:3b"
style = "conventional"
protected_branches = ["main", "master"]

How it works

1. Reads your staged diff (git diff --cached)
2. Strips binary files and scans for secrets
3. Sends the diff to your local Ollama instance
4. Returns a Conventional Commits message