Commit Companion

AI-powered Git commit assistant that summarizes staged changes using GPT.
Save time, stay in flow, and write better commit messages — automatically.

---

Features

• Uses GPT to summarize your staged diffs into clear commit messages
• Supports Conventional Commits
• Tone customization (neutral, casual, formal, funny, etc.)
• Git hook integration via prepare-commit-msg
• Supports environment variables for default TYPE and TONE
• Optional auto mode to skip confirmation (for non-interactive use)

---

Quick Start

1. Clone the repo and install dependencies:

git clone https://github.com/nelson-zack/commit-companion.git
cd commit-companion
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Add your OpenAI key to .env:

OPENAI_API_KEY=sk-...

3. Install CLI tool locally:

pip install --editable .

Usage

CLI (manual):

commit-companion suggest --tone casual --type feat

Will output something like:

feat: add basic functionality to README.md

Example usage:

git add <file>
commit-companion suggest --tone casual --type feat
git commit -m "your message here"
git push

Git Hook (auto):

Install the Git hook with:

commit-companion install-hook

This creates a .git/hooks/prepare-commit-msg script that auto-generates commit messages using GPT. By default, it uses --tone neutral and --type feat.

Once installed, your flow becomes:

git add <file>      # Stage your changes
git commit          # Commit Companion will auto-suggest the message
git push            # Push to remote

Customize per commit:

Override tone or type like this:

TYPE=fix git commit
TONE=funny git commit
TYPE=fix TONE=funny git commit

Uninstall the hook:

commit-companion uninstall-hook

Optional: Global Installation

To use commit-companion from any repo without activating a virtual environment:

1. Install globally:

pip install .

2. Add your OpenAI key to your shell config (~/.zshrc or ~/.bashrc):

export OPENAI_API_KEY="sk-..."

3. Ensure your Python bin path is on your system PATH:

export PATH="$PATH:/Library/Frameworks/Python.framework/Versions/3.12/bin"

4. Reload your shell:

source ~/.zshrc   # or ~/.bashrc

5. Use it anywhere:

commit-companion install-hook

Roadmap Ideas

• Config file support (.commitcompanion.json)
• VS Code extension
• Web version / hosted API
• PyPI distribution (pip install commit-companion)

Why Use This?

Writing commit messages breaks flow. Commit Companion helps you:

• Stay focused on your code
• Standardize commits with no effort
• Impress your teammates with clear, consistent commit messages

License

MIT License.