Skip to content

Generate perfect commit messages instantly. Let AI analyze your code changes and write conventional commits that follow your project's style.

Notifications You must be signed in to change notification settings

haadi-coder/git-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Git Agent

AI-powered commit message generator that analyzes your changes and creates meaningful commits

✨ Features

  • Smart Analysis: Examines staged changes and repository context
  • Conventional Commits: Follows your project's commit conventions automatically
  • Interactive Mode: Review and approve messages before committing
  • Multiple Providers: Supports OpenRouter with various AI models

πŸš€ Installation

go install github.com/haadi-coder/Git-Agent/cmd/ga@latest

🎯 Quick Start

  1. Stage your changes:

    git add .
  2. Generate and commit:

    export GA_API_KEY="your-openrouter-api-key"
    ga commit

βš™οΈ Configuration

Flag Environment Default Description
-k, --api-key GA_API_KEY - OpenRouter API key
-m, --model GA_MODEL openai/gpt-4o AI model to use
-t, --max-tokens GA_MAX_TOKENS 8192 Maximum tokens per session
-i, --instruction GA_INSTRUCTIONS - Custom instructions (repeatable)
-v, --verbose GA_VERBOSE false Show detailed output
-y, --non-interactive GA_NO_INTERACTIVE false Skip confirmation

πŸ’‘ Examples

# Basic usage
ga commit

# With custom instructions  
ga commit -i "Use imperative mood" -i "Keep under 50 characters"

# Non-interactive mode
ga commit -y

# Different model
ga commit -m "openai/gpt-4"

πŸ€– How It Works

  1. Analyzes your staged changes using git status and git diff --staged
  2. Understands your project structure and commit history
  3. Generates a commit message following your project's conventions
  4. Confirms with you before committing (unless -y is used)

πŸ”§ Requirements

  • Go 1.24.5+
  • Git repository
  • OpenRouter API key
Built with ❀️ for developers who care about clean Git history

About

Generate perfect commit messages instantly. Let AI analyze your code changes and write conventional commits that follow your project's style.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages