ai-gcm

AI GCM

A command-line tool that uses AI to generate meaningful git commit messages.

Features

• Analyzes git diff to understand code changes
• Generates human-readable summaries of changes
• Creates conventional commit messages
• Supports custom AI models
• Interactive prompts for staging changes

Prerequisites

1. Install Ollama:

   brew install ollama
   

2. Pull required models:

   ollama pull qwen2.5-coder  # for code analysis
   ollama pull llama3.2       # for commit message generation
   

Installation

pipx install ai-gcm

Usage

Generate Commit Message

# Stage your changes first
git add .

# Generate commit message with default models
ai-gcm generate

# Show detailed output including code changes summary
ai-gcm generate --verbose

# Use custom models
ai-gcm generate --summary-model qwen2.5-coder --commit-model llama3.2

Options

• --summary-model, -s: Model to use for code summary generation (default: qwen2.5-coder)
• --commit-model, -c: Model to use for commit message generation (default: llama3.2)
• --verbose, -v: Show detailed output including summary

Check Version

ai-gcm version

Development

1. Clone the repository

2. Install dependencies:

   poetry install
   

3. Activate the virtual environment:

   poetry shell
   

License

MIT