One file. One commit. Zero ceremony.

CLI tool / Gemini powered / v1.3.0

Give your Git history a point of view.

Turn staged diffs into concise Conventional Commits with one small command. Then split a busy change into a history you can actually understand.

open source MIT licensed works anywhere Git does
~/projects/atlas
● online
$ git add .
$ git commit-auto 1
reading staged diff
src/app.ts1 file
README.md1 file
styles.css1 file
generated 3 clean commits
feat(api): simplify request handling
docs: clarify local installation
style: refine terminal tokens
ready for your next diffdone in 1.8s
The small stack behind the ritual git curl jq Gemini API MIT licensed release 1.3.0

01 / The workflow

A better ending for every diff.

Your changes already contain the story. git-commit-auto gives that story a useful title, a clean shape, and a place in the log.

01

Stage your changes

Keep your normal Git workflow. Add the files you want to explain.

git add .
02

Let Gemini read the diff

The script selects a working model and turns context into Conventional Commit language.

analyzing...
03

Keep a history with a pulse

Commit once, push immediately, or split a busy change into focused file-sized commits.

git log --oneline

02 / Featured mode

One file.
One commit.

When a large staged change deserves more breathing room, pass a number. Each batch gets its own AI-generated message and its own place in history.

staged filesgenerated commits
01src/app.ts
02README.md
03styles.css
3 files / 3 commits

03 / Command desk

One tool.
Many good habits.

Pick a mode to see the exact command, what it does, and when it earns a place in your terminal.

04 / Start here

Your next clean commit is four steps away.

Bring your own Gemini key, install the tiny shell script, and keep your regular Git workflow. Nothing else to learn.

Get a Gemini key
01

Set your API key

Keep it in your shell environment, never in a repository.

export GEMINI_API_KEY="YOUR_API_KEY_HERE"
02

Install the script

Put the executable on your path and update it in place whenever you need.

curl -L https://git-auto.hubfly.cloud/git-commit-auto.sh -o git-commit-auto
03

Make your first clean commit

Start with one file per commit, or let the default mode choose for you.

!

A small security note. Your key is read from GEMINI_API_KEY at runtime. Keep it out of commits, logs, and shared shell history.