🧠 🧰 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 two guidelines:

• Conventional Commits v1.0.0.
• Padrões de Commits (in Portuguese).

---

Commands

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

Command	Description
install-hook	Installs GIT hooks in the default .git/hooks directory or in the custom directory configured in GIT settings.
generate-message	Generates a commit message based on the current changes (git diff context).
set-settings	Set the OpenAI settings.
help	Display information about this program.
version	Display version information.