genie-git 0.1.1

An AI-powered tool to suggest conventional git commit messages.

genie-git

An AI-powered CLI tool to suggest conventional commit messages for your staged files.

Why genie-git?

Writing well-formatted, conventional commit messages is a best practice, but it can be tedious. genie-git uses the power of Google's Gemini models to analyze your staged changes and instantly propose a high-quality commit message for you.

Features

• AI-Powered Suggestions: Automatically generates commit messages based on your staged changes.
• Conventional Commits: Enforces a consistent and readable commit history.
• Customizable: Configure the AI model, API key, and message specifications to fit your needs.
• Exclude Files: Easily exclude files from the diff to fine-tune your commit message.

Installation

Install genie-git directly from PyPI:

pip install genie-git

Quick Start

1. Get your Google API Key:

   You can generate a free Google Generative AI API key by visiting aistudio.google.com/apikey.

2. Configure genie-git:

   Set up your API key with the following command:

   genie-git configure --api-key YOUR_API_KEY
   

That's it! You're now ready to generate commit messages.

Usage

Suggest a Commit Message

To get a commit message suggestion, simply run genie-git in your repository:

genie-git suggest

This will analyze your staged changes and output a suggested commit message.

Advanced Configuration

While only an API key is needed to get started, you can further customize genie-git to fit your workflow:

genie-git configure --model gemini-1.5-pro --message-specifications "My custom instructions"

Available options:

• --api-key: Your Google Generative AI API key.
• --model: The model to use (e.g., gemini-1.5-flash).
• --message-specifications: Additional instructions for the AI.
• --number-of-commits: The number of recent commits to use as a reference.
• --show: Display the current configuration.

Exclude Files

To exclude files from the diff, use the exclude-files command:

genie-git exclude-files file1.txt path/to/file2.py