ai-git-commit

A CLI tool that generates commit messages from your staged changes using Google Gemini AI.

Demo

$ git add .
$ ai-commit
feat: add user authentication with JWT and refresh token support

Prerequisites

• Node.js 18+
• A Google Gemini API key (free)

Installation

npm install -g @konstantin-bs/ai-git-commit

Setup

Run the init command and paste your Gemini API key when prompted:

ai-commit init

Usage

Stage your changes, then run:

git add .
ai-commit

The generated message is printed to the terminal — copy and use it:

git commit -m "your generated message here"

To skip the manual step and commit automatically:

ai-commit --auto

To add, commit and push in one command:

ai-commit --push

To list all existing commands:

ai-commit --help

Language

By default commit messages are generated in English. To change the language:

ai-commit lang

Supported languages: en de es fr zh pt ja

How it works

1. Reads your staged diff via git diff --cached
2. Sends it to Gemini 2.5 Flash with a prompt to generate a concise commit message
3. Prints the result

License

MIT