🧠 GitGPT: AI-Powered Git Commit Assistant
GitGPT is a Python CLI tool that uses OpenAI's GPT models to generate meaningful Git commit messages based on diffs. It supports both EAGLE PCB design projects and generic repositories, and now includes a CLI for managing favorites, selecting models, viewing config, and even upgrading itself.
✨ Features
- 🧠 AI-powered commit messages using actual
git diff - 🗂️ Interactive repo selector + favorites system
- 📂 Supports both
eagleandgenericrepo types - 🔧 Selectable OpenAI models (e.g.
gpt-4o,gpt-4,gpt-3.5) - ⚠️ Merge conflict detection
- 🔄 Auto push and optional
git pull - ⬆️
gitgpt upgradeto update via Git or PyPI - 🧹
gitgpt clear-cacheto reset config - 🧠
gitgpt model,gitgpt favorites,gitgpt configand more
📦 Installation
1. Clone and install locally
git clone https://github.com/miniPCB/gitgpt.git
cd gitgpt
pip install .
2. Dependencies
Install requirements:
pip install -r requirements.txt
🔐 Setup
Create a secrets.json in the project root:
{
"openai_api_key": "sk-..."
}
Optionally define favorites and model in config.json:
{
"openai_model": "gpt-4o",
"favorites": [
{ "path": "C:\\Repos\\EAGLE", "type": "eagle" },
{ "path": "C:\\Repos\\MyApp", "type": "generic" }
]
}
🚀 Usage
Run with no arguments to enter commit mode:
gitgpt
Supported Commands
| Command | Alias(es) | Description |
|---|---|---|
model |
Select GPT model interactively | |
favorites |
fav |
View or delete saved Git repo favorites |
config |
cfg |
Show the current configuration |
clear-cache |
reset |
Remove all favorites and model selection |
version |
--version, ver |
Show current version |
upgrade |
up |
Pull latest from Git or upgrade via PyPI |
--help |
help, -h |
Show CLI help with command summary |
📂 Repo Types
eagle→ for EAGLE .brd, .sch, .epf, Gerber projectsgeneric→ any regular software, script, or content repo- other types like
firmware,docs,api,desktop, etc. also supported via config
🧪 Example
gitgpt favorites
gitgpt model
gitgpt
🆙 Upgrading GitGPT
gitgpt upgrade
- If installed via Git: pulls latest and reinstalls
- If installed via PyPI: runs
pip install --upgrade gitgpt - Logs to
~/gitgpt_upgrade_log.txtand shows current version
📄 License
MIT License © 2025 Nolan Manteufel
Start committing smarter, not harder. 🧠✨
Metadata
Release files for another-gitgpt 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| another_gitgpt-0.1.1.tar.gz | 10.7 kB | Without provenance | Details for another_gitgpt-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| another_gitgpt-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for another_gitgpt-0.1.1-py3-none-any.whl |
Total release size: 22.5 kB
Release files / another_gitgpt-0.1.1.tar.gz
| Download URL | another_gitgpt-0.1.1.tar.gz |
|---|---|
| Size | 10.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e2eb4e3c999d300ae07a079f3f2502048ead51852ca7c1f9ff3c92313f596c6d
|
|
BLAKE2b-256 checksum How to use checksums |
312571b4a0a2be4e687d31d31b9bba31509b97fd9d8c30e33eab23313c721f59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Release files / another_gitgpt-0.1.1-py3-none-any.whl
| Download URL | another_gitgpt-0.1.1-py3-none-any.whl |
|---|---|
| Size | 11.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
403fb1696a87f4ebdaf1a0656d040bc34e7012d627af9c50694991c73c3a48cf
|
|
BLAKE2b-256 checksum How to use checksums |
c6e7533c40a905ea408a8a6c6739467d2d3b9533a3a7f2a0ae857c1f5f7787fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Security for another-gitgpt 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.