git-copilot-commit 0.1.7

Automatically generate and commit changes using copilot

git-copilot-commit

🤖 AI-powered Git commit assistant that automatically generates conventional commit messages using GitHub Copilot.

Features

• AI-Generated Commit Messages: Uses GitHub Copilot to analyze your staged changes and generate conventional commit messages
• Multiple AI Models: Choose from GPT-4, Claude, Gemini, and other available models
• Configurable Defaults: Set a default model to use across all commits
• Message Editing: Edit generated messages using your git-configured editor or commit directly
• Conventional Commits: Follows the Conventional Commits specification
• Rich Output: Beautiful terminal output with syntax highlighting and tables

Installation

Install using uv (recommended):

uv tool install git-copilot-commit

Or with pip:

pipx install git-copilot-commit

Or without installing:

uvx git-copilot-commit --help

Prerequisites

GitHub Copilot Access: You need an active GitHub Copilot subscription

Quick Start

1. Authenticate with GitHub Copilot:

   git-copilot-commit authenticate
   

2. Make some changes in your git repository

3. Generate and commit:

   git-copilot-commit commit
   

Usage

commit

Automatically commit changes in the current git repository:

git-copilot-commit commit

Options:

• --all, -a: Stage all files before committing
• --verbose, -v: Show verbose output with file details
• --model, -m: Specify which AI model to use for generating the commit message

1. The tool analyzes your changes
2. Prompts you to stage files (if needed)
3. Generates an AI-powered commit message
4. Offers three choices:
   • (c)ommit: Commit with the generated message
   • (e)dit: Edit the message in your git-configured editor
   • (q)uit: Cancel the commit

authenticate

Set up authentication with GitHub Copilot:

git-copilot-commit authenticate

models

List available AI models:

git-copilot-commit models

config

Manage application configuration:

# Show current configuration
git-copilot-commit config --show

# Set a default model for all commits
git-copilot-commit config --set-default-model gpt-4o

Examples

Commit all changes with staging prompts:

git-copilot-commit commit --all

Commit with verbose output:

git-copilot-commit commit --verbose

Use a specific AI model:

git-copilot-commit commit --model claude-3.5-sonnet

Set up a default model and use it:

# Set default model once
git-copilot-commit config --set-default-model gpt-4o

# Now all commits will use gpt-4o by default
git-copilot-commit commit

# Override with a different model when needed
git-copilot-commit commit --model claude-3.5-sonnet

Generated Commit Message Format

The tool follows the Conventional Commits specification:

<type>[optional scope]: <description>

Supported Types:

• feat: A new feature
• fix: A bug fix
• docs: Documentation changes
• style: Code formatting (no logic changes)
• refactor: Code restructuring (no behavior changes)
• perf: Performance improvements
• test: Adding or updating tests
• chore: Maintenance tasks (tooling, dependencies, etc.)
• revert: Reverting previous changes

Example Messages:

• feat(auth): add user authentication with JWT
• fix(database): handle connection retries properly
• docs(readme): update installation instructions
• refactor(utils): simplify date parsing logic

Git Configuration

For the best experience with git-copilot-commit, consider adding this alias for the commit command:

# Add a git alias for quick access
git config --global alias.ai-commit "!git-copilot-commit commit"

# Now you can use:
git ai-commit
git ai-commit --model claude-3.5-sonnet
git ai-commit --all --verbose

You can also configure git to show more context in diffs, which can help when reviewing changes:

# Show more context in diffs
git config --global diff.context 3