cmt

README

cmt - AI-Powered Git Commit Message Generator

cmt is a Go-based CLI tool that uses Google Gemini AI to accelerate the git commit process for developers. It automatically generates messages following the Conventional Commits standards by analyzing staged changes (git diff --staged) and git log history, allowing the user to review and edit them interactively.

Features

• Multi-Provider Support: Choose your favorite AI! Support for Gemini, OpenAI, Anthropic (Claude), Groq, and Ollama (local).
• Smart Generation: Generates professional commit messages following Conventional Commits standards.
• Adjustable Styles: Support for short (subject only) or long (subject + detailed body) commit messages.
• Interactive Confirmation: A stylish in-terminal preview and confirmation dialog built with Bubble Tea. Options: Commit, Edit, Cancel.
• Secure Configuration: Your API keys and preferences are stored securely in ~/.config/cmt/config.toml.
• Smart Diff Trimming: Handles large file changes efficiently by using segmented analysis for diffs.
• Premium Console UI: Dynamically wrapped text boxes for better readability. No emojis for a clean, professional look.

Installation

For Windows

Install quickly using PowerShell:

irm https://raw.githubusercontent.com/makesikann/cmt/main/install.ps1 | iex

macOS/Linux

Using Homebrew Tap:

brew install makesikann/tap/cmt

Alternatively (Build with Go):

go install github.com/makesikann/cmt@latest

Usage

Once you have staged changes in your repository, simply run:

cmt commit

• Short Style: cmt commit --short or cmt commit -s
• Long Style: cmt commit --long or cmt commit -l

The generated message will be displayed in a dynamic preview box. You can proceed with [C]ommit, [E]dit the message, or [I]gnore/Cancel.

Managing Configuration

Use the cmt config command to manage application settings:

# List settings
cmt config show

# Set active provider (gemini, openai, anthropic, groq, ollama)
cmt config set provider openai

# Update API keys
cmt config set api-key YOUR-GEMINI-KEY
cmt config set openai-api-key YOUR-OPENAI-KEY
cmt config set anthropic-api-key YOUR-ANTHROPIC-KEY
cmt config set groq-api-key YOUR-GROQ-KEY

# Set language and model
cmt config set language en    # e.g., turkish, english
cmt config set model gpt-4o   # depends on the provider (e.g., gemini-2.5-flash, claude-3-5-sonnet-latest)
cmt config set style short    # or long

# Ollama specific
cmt config set ollama-endpoint http://localhost:11434/v1

License

This project is licensed under the MIT License.

Roadmap

• Multi-SDK support (Gemini, OpenAI, Anthropic, Groq, Ollama).
• --auto flag for non-interactive commits.
• Git hook installation support (cmt hook install).