🧠 🧰 This tool generates AI-powered commit messages via Git hooks, automating meaningful message suggestions from OpenAI and others to improve commit quality and efficiency.

[!CAUTION] This is still in development/beta. It will be GA when a major release 1 becomes available.

What this tool does

Generates a commit message based on the git diff result using the OpenAI API.

Requirements

• OpenAI API key.
• .NET 8.0 (or higher) runtime.
• GIT client.

Getting started

This repository is available at NuGet under the name AICommitMessage.

Installation

1. Install the tool globally (or per project/repository).
2. Move to the project folder.
3. Install the Git hook on the default hooks directory.

dotnet tool install -g AiCommitMessage
cd my-project/
dotnet-aicommitmessage install-hook
git add .
git commit -m ""

Use git log -1 to review the last commit details and find the automatically generated commit message.

Commit message pattern

The training model for the AI used is designed using as reference these guidelines:

• Conventional Commits v1.0.0.
• Padrões de Commits (in Portuguese).
• Conventional Commit Messages.
• Emoji for Conventional Commits.
• conventional-commit-types.

Sequence of Execution

Here’s a flow diagram showing the sequence of execution of the prepare-commit-msg hook and its integration with dotnet-aicommitmessage to generate commit messages using the OpenAI API:

graph TD
    A[Git Commit] --> B[prepare-commit-msg Hook Trigger]
    B --> C[Invoke dotnet-aicommitmessage Tool]
    C --> D[Send Data to OpenAI API]
    D --> E[Generate Commit Message]
    E --> F[Check and append pre-defined commands to Commit Message]
    F --> G[Return Generated Commit Message]
    G --> H[Insert Commit Message into Git Commit]
    H --> I[Finalize Commit]

Commands

This tool accepts an argument as the command to execute. Here is a list of available commands:

Example output

Here is an example of the commit messages generated in a real-world project: