gcommit 0.1.0

A small Git wrapper that reviews staged changes with local Ollama and prepares commit messages.

gcommit

gcommit is a small Git wrapper that reviews staged changes with a local Ollama model and prepares a commit message.

Only commit and doctor are custom. Other commands are delegated directly to git.

Install

Install Ollama first: https://ollama.com/download

ollama pull qwen2.5-coder:1.5b
pipx install gcommit
gcommit doctor

Until the PyPI release is live, install from GitHub:

pipx install git+https://github.com/ckdarby/gcommit.git@v0.1.0

Requires Python 3.10+, Git, Ollama, and pipx.

Privacy

gcommit sends staged diff excerpts to the configured Ollama endpoint. The default endpoint is local:

GCOMMIT_OLLAMA_URL=http://127.0.0.1:11434

If you set GCOMMIT_OLLAMA_URL to a remote server, staged code may be sent to that server.

Use

git add <files>
gcommit commit

gcommit commit --print
gcommit commit --yes
gcommit commit --edit
gcommit commit --model small
gcommit commit --model large
gcommit commit --fast
gcommit commit --review

Optional short alias:

alias g=gcommit
g commit

--print shows the generated subject without committing. --yes commits without prompting. --edit opens the generated subject in Git's editor.

By default, gcommit commit runs in auto mode: it uses an instant deterministic subject for obvious changes, then falls back to one structured model call. --review uses the slower chunked review path for deeper feedback. --fast skips the deterministic path and uses one model call.

Model output is rejected if it does not cover every staged file.

Manual message flows are left to Git. If you pass flags like -m, --message, -F, --amend, --fixup, or --squash, gcommit delegates to git commit.

Common safe commit flags are passed through, including --author, --date, --cleanup, --trailer, --signoff, --no-verify, --gpg-sign, --no-gpg-sign, --status, --no-status, --verbose, --quiet, and --allow-empty.

Config

Pick a model preset:

gcommit commit --model tiny
gcommit commit --model small
gcommit commit --model medium
gcommit commit --model large
gcommit commit --model xlarge
gcommit commit --model huge

Or pass any Ollama model tag:

gcommit commit --model qwen2.5-coder:14b
GCOMMIT_MODEL=qwen2.5-coder:7b gcommit commit

• GCOMMIT_MODEL: Ollama model name.
• GCOMMIT_MODE: auto, fast, or review.
• GCOMMIT_OLLAMA_URL: Ollama base URL.
• GCOMMIT_OLLAMA_TIMEOUT: request timeout in seconds.
• GCOMMIT_FAST_CHARS: maximum staged patch characters for fast mode.
• GCOMMIT_REVIEW_CHARS: maximum characters per review chunk.
• GCOMMIT_REVIEW_MAX_CHUNKS: maximum review chunks before combining overflow.

Defaults:

GCOMMIT_MODEL=qwen2.5-coder:1.5b
GCOMMIT_MODE=auto
GCOMMIT_OLLAMA_URL=http://127.0.0.1:11434

Troubleshooting

Run:

gcommit doctor

Common fixes:

ollama pull qwen2.5-coder:1.5b
pipx ensurepath
pipx upgrade gcommit

Project

• Support: SUPPORT.md
• Security: SECURITY.md
• Contributing: CONTRIBUTING.md
• Changelog: CHANGELOG.md

Develop

python3 -m pip install --require-hashes -r requirements-build.txt
python3 -m pip install --no-build-isolation --no-deps -e .
python3 -m compileall g gcommit tests
python3 -m unittest discover

Build a release package:

python3 -m pip install --require-hashes -r requirements-build.txt
python3 -m build --no-isolation