git-llm-commit 1.2.0

Generate Conventional Commit messages from your staged changes using an LLM

git-llm-commit

Generate Conventional Commit messages from your staged changes using an LLM (GPT-4).

Description

git-llm-commit is a command-line tool that analyzes your staged git changes and generates a commit message following the Conventional Commits specification using OpenAI's GPT-4 model.

Installation

1. Ensure you have Python 3.x installed
2. Install the package:

   pip install git-llm-commit
   

Setup

1. Get an OpenAI API key from OpenAI's platform

2. Set your API key in your environment:

   export OPENAI_API_KEY='your-api-key'
   

   Or create a .env file in your project root with:

   OPENAI_API_KEY=your-api-key
   

3. (Optional) Customize the LLM's creativity:

   export LLM_COMMIT_TEMPERATURE='0.5'  # More deterministic (0.0-1.0, default: 0.7)
   

   Or in your .env file:

   LLM_COMMIT_TEMPERATURE=0.5
   

Usage

1. Stage your changes as usual:

   git add .
   

2. Instead of git commit, run:

   git llm-commit
   

3. Review the generated commit message and:

   • Press y to accept and commit
   • Press n to abort
   • Press e to edit the message before committing

Features

• Generates commit messages following Conventional Commits format
• Uses GPT-4 to analyze diffs and create meaningful commit messages
• Adapts commit message detail based on change size:
  • Small changes (≤50 lines): Concise, single-line messages
  • Medium changes (51-200 lines): Moderate detail with brief body
  • Large changes (>200 lines): Detailed messages with full body and footers
• Supports interactive editing of generated messages
• Integrates with your default git editor
• Respects conventional commit types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
• Detects potentially risky files (like .env, credentials, secrets) and prompts for confirmation before committing

Security Features

Risky File Detection

The tool automatically scans staged files for potentially sensitive content like:

• .env files
• Files containing "secret" or "credentials" in the name
• Key files
• Secret/credential configuration files (yml, yaml, json, toml)

If such files are detected, you'll be prompted for confirmation before proceeding with the commit. This helps prevent accidental commits of sensitive information to your repository.

Requirements

• Python 3.x
• Git
• OpenAI API key

License

MIT License