This is a fork of OpenCommit.
- It includes functionality to use Azure OpenAPI service as a backend originating from this pull request.
- The package has been renamed to
@dvla/opencommit
for internal use. - The MIT License still applies and references the contribution from the original author
Dima Sukharev
.
- Create a file
~/.opencommit
with the following contents:
OCO_OPENAI_API_KEY=<your Azure API token>
OCO_OPENAI_BASE_PATH=<azure path for example: https://EXAMPLE.openai.azure.com/>
OCO_OPENAI_API_TYPE=azure
OCO_AZURE_DEPLOYMENT=turbo-613
OCO_AZURE_API_VERSION=2023-07-01-preview
OCO_ISSUE_ENABLED=true
OCO_ISSUE_PREFIX=ET-
-
Download the latest release .tgz file from OpenCommit Releases
-
Install OpenCommit globally to use in any repository using the latest release file:
npm install -g /PATH-TO-FILE
- You can then call OpenCommit directly to generate a commit message for your staged changes in your project:
git add <files...>
opencommit
You can also use the oco
shortcut:
git add <files...>
oco
All the commits in this repo are authored by OpenCommit — look at the commits to see how OpenCommit works. Emojis and long commit descriptions are configurable.
You can use OpenCommit by simply running it via the CLI like this oco
. 2 seconds and your staged changes are committed with a meaningful message.
-
Install OpenCommit globally to use in any repository:
npm install -g opencommit
MacOS may ask to run the command with
sudo
when installing a package globally. -
Get your API key from OpenAI or Azure. For OpenAI - Make sure that you add your payment details, so the API works. And for Azure - ensure you set up the additional config in the section below.
-
Set the key to OpenCommit config:
oco config set OCO_OPENAI_API_KEY=<your_api_key>
Your API key is stored locally in the
~/.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 oco
shortcut:
git add <files...>
oco
You can also run it with local model through ollama:
- install and start ollama
- run
ollama run mistral
(do this only once, to pull model) - run (in your project directory):
git add <files...>
AI_PROVIDER='ollama' opencommit
Create a .env
file and add OpenCommit config variables there like this:
OCO_DESCRIPTION=<boolean, postface a message with ~3 sentences description of the changes>
OCO_EMOJI=<boolean, add GitMoji>
OCO_LANGUAGE=<locale, scroll to the bottom to see options>
OCO_MESSAGE_TEMPLATE_PLACEHOLDER=<message template placeholder, default: '$msg'>
OCO_PROMPT_MODULE=<either conventional-commit or @commitlint, default: conventional-commit>
OCO_TOKENS_MAX_INPUT=<max model token limit (default: 4096)>
OCO_TOKENS_MAX_OUTPUT=<max response tokens (default: 500)>
OCO_ISSUE_ENABLED=<boolean, issue ID included within commit message - default to true if issue prefix has been set>
OCO_ISSUE_PREFIX=<optional prefix for issue ID, eg. 'ABC-'>
In addition to these config options, OpenAI and Azure can be set up with the following config variables:
OCO_OPENAI_API_KEY=<your OpenAI API token>
OCO_OPENAI_BASE_PATH=<may be used to set proxy path to OpenAI api>
OCO_MODEL=<either 'gpt-4', 'gpt-3.5-turbo-16k' (default), 'gpt-3.5-turbo-0613' or 'gpt-3.5-turbo'>
OCO_OPENAI_API_TYPE=azure
OCO_OPENAI_API_KEY=<your Azure API token>
OCO_OPENAI_BASE_PATH=<azure path for example: https://EXAMPLE.openai.azure.com/>
OCO_AZURE_DEPLOYMENT=<azure deployment name>
OCO_AZURE_API_VERSION=<azure api version>
Local config still has more priority than Global config, but you may set OCO_MODEL
and OCO_LOCALE
globally and set local configs for OCO_EMOJI
and OCO_DESCRIPTION
per repo which is more convenient.
Simply set any of the variables above like this:
oco config set OCO_MODEL=gpt-4
Configure GitMoji to preface a message.
oco config set OCO_EMOJI=true
To remove preface emojis:
oco config set OCO_EMOJI=false
By default, OpenCommit uses gpt-3.5-turbo-16k
model.
You may switch to GPT-4 which performs better, but costs ~x15 times more 🤠
oco config set OCO_MODEL=gpt-4
or for as a cheaper option:
oco config set OCO_MODEL=gpt-3.5-turbo
Make sure that you spell it gpt-4
(lowercase) and that you have API access to the 4th model. Even if you have ChatGPT+, that doesn't necessarily mean that you have API access to GPT-4.
To globally specify the language used to generate commit messages:
# de, German ,Deutsch
oco config set OCO_LANGUAGE=de
oco config set OCO_LANGUAGE=German
oco config set OCO_LANGUAGE=Deutsch
# fr, French, française
oco config set OCO_LANGUAGE=fr
oco config set OCO_LANGUAGE=French
oco config set OCO_LANGUAGE=française
The default language setting is English All available languages are currently listed in the i18n folder
OpenCommit allows you to choose the prompt module used to generate commit messages. By default, OpenCommit uses its conventional-commit message generator. However, you can switch to using the @commitlint
prompt module if you prefer. This option lets you generate commit messages in respect with the local config.
You can set this option by running the following command:
oco config set OCO_PROMPT_MODULE=<module>
Replace <module>
with either conventional-commit
or @commitlint
.
To switch to using th '@commitlint
prompt module, run:
oco config set OCO_PROMPT_MODULE=@commitlint
To switch back to the default conventional-commit message generator, run:
oco config set OCO_PROMPT_MODULE=conventional-commit
The integration between @commitlint
and OpenCommit is done automatically the first time OpenCommit is run with OCO_PROMPT_MODULE
set to @commitlint
. However, if you need to force set or reset the configuration for @commitlint
, you can run the following command:
oco commitlint force
To view the generated configuration for @commitlint
, you can use this command:
oco commitlint get
This allows you to ensure that the configuration is set up as desired.
Additionally, the integration creates a file named .opencommit-commitlint
which contains the prompts used for the local @commitlint
configuration. You can modify this file to fine-tune the example commit message generated by OpenAI. This gives you the flexibility to make adjustments based on your preferences or project guidelines.
OpenCommit generates a file named .opencommit-commitlint
in your project directory which contains the prompts used for the local @commitlint
configuration. You can modify this file to fine-tune the example commit message generated by OpenAI. If the local @commitlint
configuration changes, this file will be updated the next time OpenCommit is run.
This offers you greater control over the generated commit messages, allowing for customization that aligns with your project's conventions.
The opencommit
or oco
commands can be used in place of the git commit -m "${generatedMessage}"
command. This means that any regular flags that are used with the git commit
command will also be applied when using opencommit
or oco
.
oco --no-verify
is translated to :
git commit -m "${generatedMessage}" --no-verify
To include a message in the generated message, you can utilize the template function, for instance:
oco '#205: $msg’
opencommit examines placeholders in the parameters, allowing you to append additional information before and after the placeholders, such as the relevant Issue or Pull Request. Similarly, you have the option to customize the OCO_MESSAGE_TEMPLATE_PLACEHOLDER configuration item, for example, simplifying it to $m!"
The OCO_MESSAGE_TEMPLATE_PLACEHOLDER
feature in the opencommit
tool allows users to embed a custom message within the generated commit message using a template function. This configuration is designed to enhance the flexibility and customizability of commit messages, making it easier for users to include relevant information directly within their commits.
In our codebase, the implementation of this feature can be found in the following segment:
commitMessage = messageTemplate.replace(
config?.OCO_MESSAGE_TEMPLATE_PLACEHOLDER,
commitMessage
);
This line is responsible for replacing the placeholder in the messageTemplate
with the actual commitMessage
.
For instance, using the command oco '$msg #205’
, users can leverage this feature. The provided code represents the backend mechanics of such commands, ensuring that the placeholder is replaced with the appropriate commit message.
Once users have generated their desired commit message, they can proceed to commit using the generated message. By understanding the feature's full potential and its implementation details, users can confidently use the generated messages for their commits.
You can remove files from being sent to OpenAI by creating a .opencommitignore
file. For example:
path/to/large-asset.zip
**/*.jpg
This helps prevent opencommit from uploading artifacts and large files.
By default, opencommit ignores files matching: *-lock.*
and *.lock
You can set OpenCommit as Git prepare-commit-msg
hook. Hook integrates with your IDE Source Control and allows you to edit the message before committing.
To set the hook:
oco hook set
To unset the hook:
oco hook unset
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.
OpenCommit is now available as a GitHub Action which automatically improves all new commits messages when you push to remote!
This is great if you want to make sure all of the commits in all of your repository branches are meaningful and not lame like fix1
or done2
.
Create a file .github/workflows/opencommit.yml
with the contents below:
name: 'OpenCommit Action'
on:
push:
# this list of branches is often enough,
# but you may still ignore other public branches
branches-ignore: [main master dev development release]
jobs:
opencommit:
timeout-minutes: 10
name: OpenCommit
runs-on: ubuntu-latest
permissions: write-all
steps:
- name: Setup Node.js Environment
uses: actions/setup-node@v2
with:
node-version: '16'
- uses: actions/checkout@v3
with:
fetch-depth: 0
- uses: di-sukharev/[email protected]
with:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
env:
# set openAI api key in repo actions secrets,
# for openAI keys go to: https://platform.openai.com/account/api-keys
# for repo secret go to: <your_repo_url>/settings/secrets/actions
OCO_OPENAI_API_KEY: ${{ secrets.OCO_OPENAI_API_KEY }}
# customization
OCO_TOKENS_MAX_INPUT: 4096
OCO_TOKENS_MAX_OUTPUT: 500
OCO_OPENAI_BASE_PATH: ''
OCO_DESCRIPTION: false
OCO_EMOJI: false
OCO_MODEL: gpt-3.5-turbo-16k
OCO_LANGUAGE: en
OCO_PROMPT_MODULE: conventional-commit
That is it. Now when you push to any branch in your repo — all NEW commits are being improved by your never-tired AI.
Make sure you exclude public collaboration branches (main
, dev
, etc
) in branches-ignore
, so OpenCommit does not rebase commits there while improving the messages.
Interactive rebase (rebase -i
) changes commits' SHA, so the commit history in remote becomes different from your local branch history. This is okay if you work on the branch alone, but may be inconvenient for other collaborators.
You pay for your requests to OpenAI API on your own.
OpenCommit stores your key locally.
OpenCommit by default uses 3.5-turbo-16k model, it should not exceed $0.10 per casual working day.
You may switch to gpt-4, it's better, but more expensive.