git-ai-commit 1.0.11

A project to generate commit messages using AI

🤖 git-ai-commit

Tl;DR

• AI that writes your commit messages.

• A CLI and git hook that summarizes your changes every time you run git commit.

• Integrates with the pre-commit framework, working alongside all your git hooks.

📺 Usage

git-ai-commit currently support the following LLM providers...

• Open AI: gpt-4o-mini(default), gpt-4, gpt-3.5, and more...

• Anthropic: claude-3-haiku, claude-3-sonnet, claude-3-opus

  • Wiki: Setup Anthropic Model

• Local Ollama: llama3, mistral, phi-3, gemma, and more..

  • Wiki: Using local Ollama LLM model

🚀 Getting Started

1. Install the git-ai-commit tool via pip

pip install git-ai-commit

git-ai-commit --version # verify installation

2. Start configuring your tool

git-ai-commit config --setup

3. Your done, happy committing! Check out our fun range of command, the LLM can even help you, just run...

git-ai-commit help-ai [question?]

# or get help the ol fashion way

git-ai-commit --help

⚡️ Quick Start: Setup Git Hook

To quickly setup your prepare-commit-msg git hook, execute the command below.

Caution, this will override any existing prepare-commit-msg hooks you may have. To coordinate multiple git hook, check out the pre-commit framework.

git-ai-commit hook --setup

That is all, your good to go! Now every time you run git commit, let AI present you with a commit message.

🪝 Integrate with pre-commit framework

git-ai-commit integrates easily with your other git hook using the pre-commit framework. Follow the instructions below to get set up.

1. Install the pre-commit git hooks framework

brew install pre-commit
pre-commit --version 

2. Create a .pre-commit-config.yaml files and add the following config.

touch .pre-commit-config.yaml 

# .pre-commit-config.yaml 

default_install_hook_types: 
  # make sure you include `prepare-commit-msg` in `default_install_hook_types`
  - prepare-commit-msg
repos:
  - repo: https://github.com/the-cafe/git-ai-commit
    rev: v1.0.11
    hooks:
    -   id: git-ai-commit

3. Based on the config above, install your pre-commit hook scripts.

pre-commit install 

4. Setup your OpenAI key, see their docs for help.

git-ai-commit config --openai-key=...

🛠️ CLI Commands & Options

✨ git-ai-commit config

Display your current config settings. Option flags can be used to configure various settings in your configuration. For example...

git-ai-commit config

git-ai-commit config --openai-key=... --model=gpt-4o-mini

• -k --openai-key

  Set or update the OpenAI API key to access their GPT models.

• -a --anthropic-key

  Set or update the Anthropic API key to access their Claude models.

• -m --model

  default: "gpt-4o-mini"

  Select a model to power our tool from our supported provider. To use a Ollama model, prefix ollama/<model>.

• -ou --ollama-url

  default: "http://localhost:11434/api/chat"

  Set the URL for interacting with your local Ollama models.

• -s --setup

  Config your git hook, model, and API keys via the NUX flow.

• -l --logger

  default: false

  A toggle for enabling logs that are saved to a local file - .git/ai_commit_message.log. This was intended to be used as a local debug tool.

• -r --reset

  Resets your entire config settings to the default state. This will reset all settings, including API keys and model.

• -p --prefix

  Set a prefix for the generate commit messages.

• -ml --max-length

  Set the character limit for the LLM response. In our testing, the greater the limit the more details are included in the commit messages.

---

🔎 git-ai-commit summarize

Get a quick summary of your local changes

git-ai-commit summarize

• -u --unstaged

  Summarize your local unstaged changes.

• -d --diff

  Provide a .diff file from the local file system to summarize

---

🏷️ git-ai-commit conventional

Generate commit messages in the Conventional Commits format (type(scope): description).

This command:

1. Analyzes your staged changes using AI
2. Suggests the most appropriate commit type based on your changes
3. Suggests a relevant scope based on the affected components
4. Allows you to accept the suggestions or choose your own
5. Formats the message according to conventional commit standards
6. Gives you the option to commit and push

Available commit types:

• feat: New feature
• fix: Bug fix
• docs: Documentation changes
• style: Formatting changes
• refactor: Code refactoring
• perf: Performance improvements
• test: Adding or modifying tests
• chore: Maintenance tasks

---

📌 git-ai-commit help, -h

Displays a list of available command and options to help you setup our tool.

git-ai-commit help # -h

---

🪝 git-ai-commit hook

Manage and setup git-ai-commit as a prepare-commit-msg git hook.

git-ai-commit hook --setup

• -s --setup

  Adds a git hook by generating a .git/hooks/prepare-commit-msg script in your git repo.

• -sh --setup-husky

  Integrate our hook into your husky git hooks by generating a .husky/prepare-commit-msg script in your git repo.

• -r --remove

  Removes the git hook.

• -x --run

  Executes the custom logic for our git hook. This option was intended to only run from the prepare-commit-msg git hook.

🤝 Wanna Contribute?

Do you love our tool and wanna support us? Drop us a star 🌟

Have some feedback on what we could do better? Create a issue we'll respond in 24hrs we promise 😄

Wanna contribute code and improve our product, check out our Local Development Wiki to get started.

Right now we're focused on

• Improving our prompting strategy to generate the best commit message possible

• Super charge our CLI to support broad developer use cases and build the best interface we can

• Build some tests

🎉 Fun Facts

• In this repository, every commit prefixed with ✨ was generated by AI.