git-copilot-commit 0.1.9

Automatically generate and commit changes using copilot

git-copilot-commit

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

Features

• Generates commit messages based on your staged changes
• Supports multiple AI models: GPT-4, Claude, Gemini, and more
• Allows editing of generated messages before committing
• Follows the Conventional Commits standard

Installation

Install with uv (recommended):

uv tool install git-copilot-commit

Or with pipx:

pipx install git-copilot-commit

Or run directly with uv:

uvx git-copilot-commit --help

Prerequisites

• Active GitHub Copilot subscription

Quick Start

1. Authenticate with GitHub Copilot:

git-copilot-commit authenticate

2. Make changes in your repository.

3. Generate and commit:

git-copilot-commit commit

Usage

Commit changes

$ uvx git-copilot-commit commit --help
Usage: git-copilot-commit commit [OPTIONS]

  Automatically commit changes in the current git repository.

Options:
  -a, --all         Stage all files before committing
  -v, --verbose     Show verbose output
  -m, --model TEXT  Model to use for generating commit message
  --help            Show this message and exit.

Authenticate

$ uvx git-copilot-commit authenticate --help
Usage: git-copilot-commit authenticate [OPTIONS]

  Autheticate with GitHub Copilot.

Options:
  --help  Show this message and exit.

List models

$ uvx git-copilot-commit models --help
Usage: git-copilot-commit models [OPTIONS]

  List models available for chat in a Rich table.

Options:
  --help  Show this message and exit.

Configure

$ uvx git-copilot-commit config --help
Usage: git-copilot-commit config [OPTIONS]

  Manage application configuration.

Options:
  --set-default-model TEXT  Set default model for commit messages
  --show                    Show current configuration
  --help                    Show this message and exit.

Examples

Commit all changes:

git-copilot-commit commit --all

Verbose output:

git-copilot-commit commit --verbose

Use a specific model:

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

Set and use a default model:

git-copilot-commit config --set-default-model gpt-4o
git-copilot-commit commit
git-copilot-commit commit --model claude-3.5-sonnet

Commit Message Format

Follows Conventional Commits:

<type>[optional scope]: <description>

Types:

• feat: New feature
• fix: Bug fix
• docs: Documentation
• style: Formatting only
• refactor: Code restructure
• perf: Performance
• test: Tests
• chore: Maintenance
• revert: Revert changes

Examples:

• feat(auth): add JWT authentication
• fix(db): retry connection on failure
• docs(readme): update install steps
• refactor(utils): simplify date parsing

Git Configuration

Add a git alias by adding the following to your ~/.gitconfig:

[alias]
    ai-commit = "!f() { git-copilot-commit commit $@; }; f"

Now you can run:

git ai-commit
git ai-commit --model claude-3.5-sonnet
git ai-commit --all --verbose

Show more context in diffs:

git config --global diff.context 3