AI Git Commit Generator & Code Assistant

Stop writing vague commit messages like "fix", "update", or "changes".

AI Git Commit Generator is a lightweight, blazing-fast CLI tool that inspects your staged changes (git diff --cached) and handles the heavy lifting of writing clean, descriptive, and standardized commit messages using AI (locally via Ollama or cloud-based via Groq and OpenRouter).

Core Features (Free Version)

• Smart Analysis: Scans your git diff and identifies what changed in your code (up to 2,000 characters).
• Conventional Commits: Automatically formats messages according to standard practices (feat:, fix:, docs:, etc.).
• Hybrid Architecture: Works 100% locally (via Ollama) or cloud-based (via free Groq and OpenRouter models).
• Local API Key Storage: Save your Groq/OpenRouter keys locally once and run the tool without setting environment variables every time.
• Interactive Menu: Review, edit, or regenerate suggested messages before committing.
• Open-Source Repository: Check out the source code and contribute on GitHub (XBarni999/ai-git-commit-generator).

PRO FEATURES (Unlocked via Itch.io Purchase)

Supercharge your daily Git workflow with advanced developer tools:

• Detailed Commit Explanations: Auto-generates structured, multi-line explanations (up to 3 lines) explaining "why" and "what" changed, automatically formatted and wrapped at 72 characters.
• Large Diff Support: Analyzes diffs up to 16,000 characters (instead of 2,000 for Free), perfect for large updates.
• AI Code Review (--review): Audits your staged changes for logic bugs, security vulnerabilities, and code style improvements before you make a commit.
• PR Description Generator (--pr): Automatically drafts a beautifully formatted Markdown template for your Pull Requests containing Descriptions, Key Changes, and Testing summaries.
• Smart Integrations: Automatically extracts ticket codes (e.g. [PROJ-123]) from your active Git branch and prepends them, plus toggles Gitmoji commit prefixes.
• Premium Custom Models: Override default endpoints with any premium cloud models (Claude 4.5 Sonnet, GPT-4, etc.).

Free vs Pro Comparison

Feature	Free Version	Pro Version
Supported Engines	Ollama, Groq, OpenRouter	Ollama, Groq, OpenRouter
Commit Message Body	Subject only (1 line)	Rich body (2-3 lines, wrapped at 72 chars)
Diff Character Limit	Up to 2,000 chars	Up to 16,000 chars
Custom Cloud Models	Default model only	Any model (Claude, GPT-4o, etc.)
AI Code Reviews (--review)	❌	✅ Full Audit Reports
PR Descriptions (--pr)	❌	✅ Automated Templates
Smart Integrations (Jira & Gitmoji)	❌	✅ Auto branch-matching & Emojis

How to Install & Use

1. Install globally:

   pip install ai-git-commit-generator

2. (Optional) Save API Keys locally:

   ai-commit --setup-groq "your_groq_key"
   ai-commit --setup-openrouter "your_openrouter_key"

3. Stage your changes & run:

   ai-commit

How to Activate Your PRO License

After purchase, you will receive a unique License Key (format: AICOMMIT-PRO-XXXX-YYYY).

To unlock all premium features, simply run:

ai-commit --register YOUR_LICENSE_KEY_HERE

Check your status at any time:

ai-commit --status