Note: HappyCommit works but is still early. Check any generated commit message thoroughly before saving it! And we're always open for a PR. Thanks for using and contributing!

HappyCommit is a delightful tool that harnesses the power of OpenAI's GPT-3.5 Turbo language model to generate meaningful and descriptive Git commit messages for you. With HappyCommit, you can now focus on writing great code while we take care of crafting the perfect commit messages.

• Make sure you have Homebrew installed on your macOS system.

1. To begin your journey with HappyCommit, install it by running the following commands:

   brew tap jackbackes/git-commit-gpt
   brew install jackbackes/homebrew-git-commit-gpt/git-commit-gpt

2. After the installation, let's add your OpenAI API key to the configuration file. Simply run the following command and enter your API key when prompted:

   printf "Enter your OPENAI_API_KEY: " && read -rs api_key && mkdir ~/.happycommit >> /dev/null && echo "OPENAI_API_KEY = \\\"$api_key\\\"" >> ~/.happycommit/config.toml

   Don't have an OpenAI API key yet? No worries! Grab one from your OpenAI account.

3. That's it! HappyCommit is now ready to make your Git experience more enjoyable. Just use the git commit-gpt command to generate and add a commit message based on your code changes.

...Coming soon!

...Coming soon!

1. Install Rust and Cargo by following the instructions here.
2. Install the "Just" task runner by following the instructions here or just run cargo install just.

git clone git@github.com:jackbackes/happycommit.git
cd happycommit
just install
./add-openai-api-key.sh

Instead of running the standard git commit command, use this friendly alternative:

git add .
git commit-gpt

HappyCommit will analyze your staged changes and generate a meaningful commit message that brings a smile to your face.

We'd love for you to join us in making HappyCommit even better! If you have suggestions, feature requests, or bug reports, please feel free to open an issue or submit a pull request on our GitHub repository. We're excited to see your contributions!

HappyCommit is warmly licensed under the Apache License 2.0.