llm-commit

LLM plugin for generating Git commit messages using an LLM.

Installation

Install this plugin in the same environment as LLM.

llm install llm-commit

Usage

The plugin adds a new command, llm commit. This command generates a commit message from your staged Git diff and then commits the changes.

For example, to generate and commit changes

# Stage your changes first
git add .

# Generate and commit with an LLM-generated commit message
llm commit

You can also customize options:

# Skip the confirmation prompt
llm commit --yes

# Use a different LLM model, adjust max tokens, or change the temperature
llm commit --model gpt-4 --max-tokens 150 --temperature 0.8

# Control diff truncation behavior
llm commit --truncation-limit 2000  # Truncate diffs longer than 2000 characters
llm commit --no-truncation         # Never truncate diffs (use with caution on large changes)

Development

To set up this plugin locally, first check out the code. Then create a new virtual environment:

cd llm-commit
python3 -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

python -m pytest