AI Commits

A CLI that writes your git commit messages for you with AI. Never write a commit message again.

--- ## Setup > The minimum supported version of Node.js is the latest v14. Check your Node.js version with `node --version`. 1. Install _aicommits_: ```sh npm install -g aicommits ``` 2. Retrieve your API key from [OpenAI](https://platform.openai.com/account/api-keys) > Note: If you haven't already, you'll have to create an account and set up billing. 3. Set the key so aicommits can use it: ```sh aicommits config set OPENAI_KEY= ``` This will create a `.aicommits` file in your home directory. ### Upgrading Check the installed version with: ``` aicommits --version ``` If it's not the [latest version](https://github.com/Nutlope/aicommits/releases/latest), run: ```sh npm update -g aicommits ``` ## Usage ### CLI mode You can call `aicommits` directly to generate a commit message for your staged changes: ```sh git add aicommits ``` `aicommits` passes down unknown flags to `git commit`, so you can pass in [`commit` flags](https://git-scm.com/docs/git-commit) (with some exceptions (e.g. `--all`): ```sh aicommits --dry-run ``` > 👉 **Tip:** Use the `aic` alias if `aicommits` is too long for you. ### Git hook You can also integrate _aicommits_ with Git via the [`prepare-commit-msg`](https://git-scm.com/docs/githooks#_prepare_commit_msg) hook. This lets you use Git like you normally would, and edit the commit message before committing. #### Install In the Git repository you want to install the hook in: ```sh aicommits hook install ``` #### Uninstall In the Git repository you want to uninstall the hook from: ```sh aicommits hook uninstall ``` #### Usage 1. Stage your files and commit: ```sh git add git commit # Only generates a message when it's not passed in ``` > If you ever want to write your own message instead of generating one, you can simply pass one in: `git commit -m "My message"` 2. Aicommits will generate the commit message for you and pass it back to Git. Git will open it with the [configured editor](https://docs.github.com/en/get-started/getting-started-with-git/associating-text-editors-with-git) for you to review/edit it. 3. Save and close the editor to commit! ## How it works This CLI tool runs `git diff` to grab all your latest code changes, sends them to OpenAI's GPT-3, then returns the AI generated commit message. Video coming soon where I rebuild it from scratch to show you how to easily build your own CLI tools powered by AI. ## Future tasks - Add support for conventional commits as a flag that users can enable - Migrate to chatGPT instead of GPT-3 - Add support for diffs greater than 200 lines by grabbing the diff per file, optional flag - Add ability to specify a commit message from inside aicommit if user doesn't like generated one - Play around with prompt to produce optimal result - Add an alias called `aic` that does "git add . && aicommits && git push" - Add opt-in emoji flag to preface commits with an emoji, use [this](https://gitmoji.dev) as a guide - Add opt-in languages flag where it returns the commit in different languages - Build landing page for the 2.0 launch ## Maintainers - **Hassan El Mghari**: [@Nutlope](https://github.com/Nutlope) [

](https://twitter.com/nutlope) - **Hiroki Osame**: [@privatenumber](https://github.com/privatenumber) [

](https://twitter.com/privatenumbr) ## Contributing If you want to help fix a bug or implement a feature in [Issues](https://github.com/Nutlope/aicommits/issues), checkout the [Contribution Guide](CONTRIBUTING.md) to learn how to setup and test the project.