Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guibranco/dotnet-aicommitmessage
🧠🧰 This tool generates AI-powered commit messages via Git hooks, automating meaningful message suggestions from OpenAI and others to improve commit quality and efficiency.
https://github.com/guibranco/dotnet-aicommitmessage
ai ai-powered api dotnet-tool git-commit-messages git-hooks ia openai
Last synced: 19 days ago
JSON representation
🧠🧰 This tool generates AI-powered commit messages via Git hooks, automating meaningful message suggestions from OpenAI and others to improve commit quality and efficiency.
- Host: GitHub
- URL: https://github.com/guibranco/dotnet-aicommitmessage
- Owner: guibranco
- License: mit
- Created: 2024-09-16T19:45:47.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-21T07:03:54.000Z (23 days ago)
- Last Synced: 2024-10-21T10:00:40.668Z (23 days ago)
- Topics: ai, ai-powered, api, dotnet-tool, git-commit-messages, git-hooks, ia, openai
- Language: C#
- Homepage: https://guibranco.github.io/dotnet-aicommitmessage/
- Size: 842 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
🧠🧰 This tool generates AI-powered commit messages via Git hooks, automating meaningful message suggestions from OpenAI and others to improve commit quality and efficiency.
[](https://wakatime.com/badge/github/guibranco/dotnet-aicommitmessage)
[](https://wakatime.com/badge/github/guibranco/dotnet-aicommitmessage)
[](https://wakatime.com/badge/github/guibranco/dotnet-aicommitmessage)
[](https://github.com/guibranco/dotnet-aicommitmessage/actions/workflows/build.yml)
[](https://github.com/guibranco/dotnet-aicommitmessage/actions/workflows/ci.yml)
[](https://github.com/guibranco/dotnet-aicommitmessage/actions/workflows/infisical-secrets-check.yml)
[](https://github.com/guibranco/dotnet-aicommitmessage/actions/workflows/linter.yml)
---
> [!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](https://platform.openai.com/docs/overview).
---
## Requirements
- [OpenAI API key](https://platform.openai.com/api-keys).
- [.NET 8.0 (or higher) runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
- [GIT client](https://git-scm.com/downloads).
---
## Getting started
[](https://www.nuget.org/packages/AICommitMessage/)
[](https://www.nuget.org/packages/AICommitMessage/)
This repository is available at [NuGet](https://www.nuget.org) under the name [AICommitMessage](https://www.nuget.org/packages/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.
```ps
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](https://www.conventionalcommits.org/en/v1.0.0/).
- [Padrões de Commits](https://github.com/tiagolofi/padroes-de-commits) (in Portuguese).
- [Conventional Commit Messages](https://gist.github.com/qoomon/5dfcdf8eec66a051ecd85625518cfd13).
- [Emoji for Conventional Commits](https://gist.github.com/parmentf/359667bf23e08a1bd8241fbf47ecdef0).
- [conventional-commit-types](https://github.com/pvdlg/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:
```mermaid
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[Return Generated Commit Message]
F --> G[Insert Commit Message into Git Commit]
G --> H[Finalize Commit]
```
---
## 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. |
```