Skip to content

dotninth/xenogit

Repository files navigation

Your CLI buddy for instant Git commit messages.

Project Version PHP Version MIT License

Introduction

Xenogit is your helpful command-line assistant that uses OpenAI GPT to quickly create commit messages that follow the Conventional Commit specification. Stop spending time writing commits and start managing your Git repository effortlessly!

️Getting Started

Installing

There are two ways to install Xenogit:

  1. Using Composer: Run the following command to install Xenogit globally:
composer global require dotninth/xenogit
  1. Downloading from GitHub: Visit the Releases page on GitHub and download the appropriate binary.

Usage

After installing Xenogit, you can all available options by simply launcing the program:

$ xenogit

  Xenogit  v1.3.2

  USAGE:  <command> [options] [arguments]

  commit         Automatically generate commit messages

  config:api-key Configure the API key in the .env file

API Key

Xenogit needs an API key from OpenAI to work properly. There are two options to provide the API key:

  1. Use the command xenogit config:api-key <your-api-key>.

  2. Using environment variable: Create an environment variable called API_KEY that contains your OpenAI API key.

  3. Create a file named .env in the directory where the Xenogit binary is located. This file will be used to store your environment variables. To the .env file, add the following line, replacing <YOUR_API_KEY> with your actual OpenAI API key:

API_KEY=<YOUR_API_KEY>

Payment

Using Xenogit will cost you money for each request you make to the OpenAI API. Xenogit uses the official ChatGPT (gpt-3.5-turbo-16k) model, which costs approximately 15 times less than GPT-4. Make sure you have enough funds or credits in your OpenAI account to pay for your usage of Xenogit.

To find out more about the price for using OpenAI's services, please check their pricing page at OpenAI Pricing page.

Contribute

You are welcome to contribute to Xenogit! For a smooth collaboration, please follow these guidelines when contributing to the project:

  1. Fork the repository and clone it to your local machine.
  2. Create a new branch for your contribution: git checkout -b my-contribution.
  3. Make your changes, making sure the code follows the project's coding style and conventions.
  4. Test your changes thoroughly.
  5. Commit your changes with a descriptive commit message, following the Conventional Commit specification.
  6. Push your branch to your forked repository: `git push origin my-contribution'.
  7. Open a pull request against the `main' branch of the Xenogit repository.
  8. Provide a clear and detailed description of your changes in the pull request, along with any relevant information or context.

Please note that by contributing to Xenogit, you agree to release your contributions under the MIT License.

License

Xenogit is released under the MIT License. Feel free to modify and distribute it according to your needs.