gitai-cli 0.3.0

AI-powered git commit message generator

gitai

AI-powered git commit message generator. Analyzes your staged changes and suggests meaningful commit messages — using any LLM you already have access to.

Features

• Reads your staged git diff and generates commit message suggestions (3 by default, configurable)
• Interactive selection: pick a suggestion or write your own
• Supports multiple providers: Ollama (local), OpenAI, Anthropic, Gemini, and more
• Two commit styles: Conventional Commits or free-form
• Optional emoji (gitmoji) support

Installation

pip install gitai

Requires Python 3.11+.

Quick start

# 1. Stage your changes
git add .

# 2. Run gitai
gitai commit

gitai reads the diff, calls your configured LLM, and presents 3 suggestions to choose from.

Usage

gitai commit                   Generate commit message suggestions for staged changes
gitai commit --push            Push to remote automatically after committing
gitai commit -n 5              Generate 5 suggestions instead of the default 3
gitai commit --suggestions 5   Same as above
gitai config                   View and update settings
gitai --version                Show version
gitai --help                   Show help

Configuration

Run gitai config to update settings interactively. Settings are stored in ~/.gitai.toml.

Key	Default	Description
provider	ollama	LLM provider
model	llama3.2	Model name
ollama_url	http://localhost:11434	Ollama API base URL (Ollama only)
commit_style	conventional	conventional or free-form
emoji	false	Prefix suggestions with gitmoji
num_suggestions	3	Number of suggestions to generate

Supported providers

Provider	provider value	Example model value	API key env var
Ollama (local)	ollama	llama3.2, mistral	—
Anthropic	anthropic	claude-sonnet-4-6, claude-haiku-4-5-20251001	ANTHROPIC_API_KEY
OpenAI	openai	gpt-4o, gpt-4o-mini	OPENAI_API_KEY
Gemini	gemini	gemini-2.0-flash	GEMINI_API_KEY

For cloud providers, set the API key in your shell profile:

bash/zsh (~/.bashrc or ~/.zshrc):

export ANTHROPIC_API_KEY=sk-ant-...

PowerShell ($PROFILE):

$env:ANTHROPIC_API_KEY="sk-ant-..."

Example ~/.gitai.toml

provider = "anthropic"
model = "claude-haiku-4-5-20251001"
commit_style = "conventional"
emoji = false
ollama_url = "http://localhost:11434"

Local setup (Ollama)

If you want to run fully offline with Ollama:

1. Install Ollama
2. Pull a model: ollama pull llama3.2
3. Run gitai commit — no API key needed

TODO

• Allow configuring the number of suggestions generated
• Support unstaged changes with an optional --all flag