commit-with-ai 1.0.0

AI-powered git commit message generator using Gemini API

Git Auto-Commit with Gemini API

AI-powered git commit message generator using Gemini API's structured JSON output.

What It Does

Analyzes your staged git changes and generates 5 Conventional Commits-compliant commit message suggestions using Gemini AI. Select one or enter your own.

Installation

Via PyPI (Recommended)

# Use uvx (no installation required)
uvx commit-with-ai

# Or install globally
pip install commit-with-ai

From Source

# Clone the repository
git clone https://github.com/chenwei791129/git-auto-commit.git
cd git-auto-commit

# Run directly with uv
uv run commit_with_ai.py

Setup

1. Configure API Key

Set your Gemini API key as an environment variable:

export GEMINI_API_KEY="your-api-key-here"

Get your API key from Google AI Studio.

For persistent configuration, add to your shell profile (~/.bashrc, ~/.zshrc):

export GEMINI_API_KEY="your-api-key-here"

2. Configure Git Alias (Optional)

Add to your ~/.gitconfig:

[alias]
    # If installed via pip
    ac = !commit-with-ai

    # Or if using uvx (no installation)
    ac = !uvx commit-with-ai

    # Or if running from source
    ac = !/your-script-path/git-auto-commit/commit_with_ai.py

Usage

git add <files>
git ac

Example

Analyzing staged changes...
Generating commit message options with Gemini API...

======================================================================
Select a commit message:
======================================================================
1. feat(auth): add user authentication system
2. feat: implement login and registration flow
3. chore(deps): add authentication dependencies
4. docs: update README with auth setup instructions
5. refactor(auth): restructure authentication module
6. Enter custom message
7. Cancel
======================================================================

Enter selection [1-7]:

Resources

• Conventional Commits
• Gemini API Documentation