Commit GPT

A CLI that writes your git commit messages for you with AI. Never write a commit message again.

Installation

The easiest way to install and keep CommitGPT updated.

Install:

brew tap ZPVIP/commitgpt https://github.com/ZPVIP/commitgpt
brew install commitgpt

Upgrade:

brew update
brew upgrade commitgpt

Uninstall:

brew uninstall commitgpt
# Optional: Remove configuration files manually
rm -rf ~/.config/commitgpt

Method 2: RubyGems (For Ruby Developers)

Click to expand RubyGems installation instructions #### Prerequisites: Install Ruby If you don't have Ruby installed, follow these steps first.
macOS **1. Install Homebrew** (skip if already installed) ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` **2. Install Ruby dependencies** ```bash brew install openssl@3 libyaml gmp rust ```
Ubuntu / Debian **Install Ruby dependencies** ```bash sudo apt-get update sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev ```

Install Ruby with Mise (version manager)

# Install Mise
curl https://mise.run | sh

# For zsh (macOS default)
echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.zshrc
source ~/.zshrc

# For bash (Ubuntu default)
# echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.bashrc
# source ~/.bashrc

# Install Ruby
mise use --global ruby@3

# Verify installation
ruby --version
#=> 3.4.7

# Update RubyGems
gem update --system

Install CommitGPT

gem install commitgpt

Configuration

CommitGPT uses a YAML configuration system (~/.config/commitgpt/) to support multiple providers and per-provider settings.

Run the setup wizard to configure your provider:

$ aicm setup

You'll be guided to:

  1. Choose an AI provider (Presets: Cerebras, OpenAI, Ollama, Groq, etc.)
  2. Enter your API Key (stored securely in config.local.yml)
  3. Select a model interactively
  4. Set maximum diff length

Note: Please add ~/.config/commitgpt/config.local.yml to your .gitignore if you are syncing your home directory, as it contains your API keys.

Usage

Generate Commit Message

Stage your changes and run aicm:

$ git add .
$ aicm

Switch Provider

Switch between configured providers easily:

$ aicm -p
# or
$ aicm --provider

Select Model

Interactively list and select a model for your current provider:

$ aicm -m
# or
$ aicm --models

Choose Commit Message Format

Select your preferred commit message format:

$ aicm -f
# or
$ aicm --format

CommitGPT supports three commit message formats:

  • Simple - Concise commit message (default)
  • Conventional - Follow Conventional Commits specification
  • Gitmoji - Use Gitmoji emoji standard

Your selection will be saved in ~/.config/commitgpt/config.yml and used for all future commits until changed.

Format Examples

Simple:

Add user authentication feature

Conventional:

feat: add user authentication feature
fix: resolve  timeout issue
docs: update API documentation

Gitmoji:

Check Configuration

View your current configuration (Provider, Model, Format, Base URL, Diff Len):

$ aicm help

(Use the help command to see current active provider settings)

View Git Diff

Preview the diff that will be sent to the AI:

$ aicm -v

Update

To update to the latest version (if installed via Gem):

$ gem update commitgpt

Supported Providers

We support any OpenAI-compatible API. Presets available for:

  • Cerebras (Fast & Recommended)
  • OpenAI (Official)
  • Apple (Local via apple-to-openai)
  • Ollama (Local)
  • Groq
  • DeepSeek
  • Anthropic (Claude)
  • Google AI (Gemini)
  • Mistral
  • OpenRouter
  • Local setups (LM Studio, LLaMa.cpp, Llamafile)

OpenAI (https://platform.openai.com)

gpt-4o
gpt-4o-mini

Cerebras (https://cloud.cerebras.ai) ⭐ Recommended

zai-glm-4.7          # ⭐ Best for commit messages - fast & accurate
llama3.1-8b
llama-3.3-70b

Groq (https://console.groq.com)

llama-3.3-70b-versatile
llama-3.1-8b-instant

Apple Local Models (via apple-to-openai)

Note: Due to the context window limits of Apple's local models, it is highly recommended to set your max diff length (diff_len) to 10000 during setup. When prompted for large diffs, select the Smart chunked mode to avoid errors.

How It Works

This CLI tool runs a git diff command to grab all staged changes, sends this to OpenAI's GPT API (or compatible endpoint), and returns an AI-generated commit message. The tool uses the /v1/chat/completions endpoint with optimized prompts/system instructions for generating conventional commit messages.

Special Thanks

I used ChatGPT to convert AICommits from TypeScript to Ruby. Special thanks to https://github.com/Nutlope/aicommits

Development Guide

Requirements

  • Ruby >= 2.6.0
  • Git

Local Setup

  1. Clone the repository: bash git clone https://github.com/ZPVIP/commitgpt.git cd commitgpt
  2. Install dependencies: bash bundle install

Local Build and Install

To test your changes locally (builds the gem and installs it to your system):

gem build commitgpt.gemspec
gem install ./commitgpt-*.gem

Publishing

RubyGems

To publish a new version to RubyGems.org (requires RubyGems account permissions):

gem push commitgpt-*.gem

Homebrew (GitHub Distribution)

We use a custom script to automate the GitHub Release and Homebrew Formula update process. This enables users to install via brew tap.

Steps:

./scripts/release.sh <version>
# Example: ./scripts/release.sh 0.3.1

This script automates:

  1. Creating and pushing a Git Tag.
  2. Creating a GitHub Release (which generates the source tarball).
  3. Calculating the SHA256 checksum of the tarball.
  4. Updating Formula/commitgpt.rb with the new URL and checksum.
  5. Committing and pushing the updated Formula to the repository.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ZPVIP/commitgpt. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the CommitGpt project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.