๐Ÿ‘ปcommitghost

Your terminal, politely haunted
into better commit habits.

commitghost reads your staged diff, your repo's recent commit style, and writes a few candidate commit messages for you to pick from. Optionally, get pleasently haunted when you've let a diff grow too long and it's time to commit soon.

npm install -g commitghost View on GitHub
MIT licensed ยท works with Anthropic, OpenAI, or local Ollama ยท zero telemetry
~/commitghost

Four things.

commitghost doesn't try to be a git client. It does three specific jobs well, and gets out of your way.

โ—‡ read the diff

Reads what actually changed

Uses your staged diff and repo's recent commit style to write commit messages that match how your team already commits.

โ— pick or edit

You always get the last word

Every run generates a few candidates. Pick one, edit it inline, or regenerate. Nothing gets committed without you choosing the exact words.

๐Ÿ‘ปa ghost companion

A friendly ghost

If you go too long without committing, the ghost appears above your next prompt to remind you it's time to wrap up the next atomic commit. All configurable, and completely optional.

โŽˆ runs offline

Free and private with Ollama

No API key, no cloud calls, no cost. Point commitghost at a local Ollama model and it writes commit messages entirely on your machine.

Two commands, three ways to run it

Works with a Ollama, Anthropic or OpenAI key. commitghost never sends any telemetry or history. Once installed, run it as commitghost, the shorter commitg, or straight from git as git commitg. Whichever fits your muscle memory better.

npm install -g commitghost
commitghost --config
git commitg