OpenCommit

Author @di-sukharev

GPT CLI to auto-generate impressive commits in 1 second

Killing lame commits with AI 🤯🔫

All the commits in this repo are done with OpenCommit — look into the commits to see how OpenCommit works. Emoji and long commit description text is configurable.

The minimum supported version of Node.js is the latest v14. Check your Node.js version with node --version.

1. Install opencommit globally to use in any repository:

   npm install -g opencommit

2. Get your API key from OpenAI. Make sure you add payment details, so API works.

3. Set the key to opencommit config:

   opencommit config set OPENAI_API_KEY=<your_api_key>

   Your api key is stored locally in ~/.opencommit config file.

You can call opencommit directly to generate a commit message for your staged changes:

git add <files...>
opencommit

You can also use the oc shortcut:

git add <files...>
oc

GitMoji convention is used.

To add emoji:

oc config set emoji=true

To remove emoji:

oc config set emoji=false

To add descriptions:

oc config set description=true

To remove description:

oc config set description=false

You can set opencommit as Git prepare-commit-msg hook. Hook integrates with you IDE Source Control and allows you edit the message before commit.

To set the hook:

oc hook set

To unset the hook:

oc hook unset

In the hook, there is a check that checks if the commit message is not empty. If it is not, the hook will not run. To skip that check and always replace the commit message run:

oc config set skipCommitMsgHookSourceCheck=true

To use the hook:

git add <files...>
git commit

Or follow the process of your IDE Source Control feature, when it calls git commit command — OpenCommit will integrate into the flow.

You pay for your own requests to OpenAI API. OpenCommit uses ChatGPT official model, that is ~10x times cheaper than GPT-3.