git-autoc

AI-powered git commit message generator. Reads your staged changes and writes a conventional commit message using any OpenAI-compatible API.

Features

• Generates Conventional Commits from your staged diff
• Uses your recent commit history for style-consistent output
• Interactive confirmation (y / e / N) before committing
• Dry-run mode with no side effects
• Three body styles: long, bullet list, paragraph
• Works with any OpenAI-compatible API (Ollama, LM Studio, OpenAI, …)
• Configuration managed from the CLI — no .env

Installation

Requires Python 3.13+.

Run the latest version without installing anything:

uvx git-autoc --help

Or install it as a command so git-autoc lands on your PATH:

uv tool install git-autoc
git-autoc --help

Usage

Stage the changes you want to commit, then run:

uvx git-autoc

The tool generates a commit message, shows it, and asks how to proceed:

• y — commit with the generated message
• e — open the editor to adjust the message before committing
• N (default) — abort, keep changes staged

To generate without committing (or to preview the message first):

uvx git-autoc --dry-run

Options

--long, --list, and --desc are mutually exclusive.

Body styles

Configuration

Configuration lives in ~/.config/git-autoc/config.toml.

Show the current configuration (creates a default file on first run):

uvx git-autoc config

Set a value interactively:

uvx git-autoc config set openai_model

Settings

openai_base_url and openai_model are required and must be non-empty; the tool refuses to run otherwise.

Development

make run     # run the CLI
make format  # format code (ruff)
make check   # type check (ty) + lint + format check
make test    # run tests (pytest)

Project layout

src/git_autoc/
├── main.py           # CLI (typer), wires all layers
├── core/config.py    # settings, TOML loading, config management
├── git/utils.py      # git operations (diff, log, stage, commit)
└── llm/              # prompt building, provider, commit styles

Stack

• CLI: typer + rich
• Config: pydantic + tomllib
• AI client: openai (OpenAI-compatible API)
• Quality: ruff, ty, pytest