fork
于 aicommits,使用 智谱AI · GML4 生成git commit message
,大部分API
兼容 aicommits 文档。
-
使用流程
-
Install
pnpm add aicommits-glm -g
-
在 此处 获取
智谱AI API Key
-
配置
API KY
aicommits config set AI_KEY=<your token>
-
-
可配置工作区
.aicommits
aicommits config set AI_KEY=<your token>
将会在全局创建
.aicommits
文件,用作全局配置。可使用-w
aicommits config set AI_KEY=<your token> -w aicommits config set type=conventional -w # 该项目下使用 conventional 规范的commit信息 aicommits config set locale=zh-CN -w # 该项目下使用中文做为 commit 信息
可在工作区生成配置文件,文件项会覆盖全局配置。
注意!!!谨慎保存你的 AI KEY, 不要把 KEY 写到工作区配置中,一旦上传至远程仓库,很容易造成泄露。
The minimum supported version of Node.js is the latest v14. Check your Node.js version withnode --version
.
-
Install aicommits:#npm install -g aicommits
-
Retrieve your API key from AINote: If you haven't already, you'll have to create an account and set up billing. -
Set the key so aicommits can use it:#aicommits config set OPENAI_KEY=<your token>
This will create a.aicommits
file in your home directory.
Check the installed version with:
aicommits --version
If it's not the latest version, run:
npm update -g aicommits
You can call aicommits
directly to generate a commit message for your staged changes:
git add <files...>
aicommits
aicommits
passes down unknown flags to git commit
, so you can pass in commit
flags.
For example, you can stage all changes in tracked files with as you commit:
aicommits --all # or -a
👉 Tip: Use the
aic
alias ifaicommits
is too long for you.
Sometimes the recommended commit message isn't the best so you want it to generate a few to pick from. You can generate multiple commit messages at once by passing in the --generate <i>
flag, where 'i' is the number of generated messages:
aicommits --generate <i> # or -g <i>
Warning: this uses more tokens, meaning it costs more.
If you'd like to generate Conventional Commits, you can use the --type
flag followed by conventional
. This will prompt aicommits
to format the commit message according to the Conventional Commits specification:
aicommits --type conventional # or -t conventional
This feature can be useful if your project follows the Conventional Commits standard or if you're using tools that rely on this commit format.
You can also integrate aicommits with Git via the prepare-commit-msg
hook. This lets you use Git like you normally would, and edit the commit message before committing.
In the Git repository you want to install the hook in:
aicommits hook install
In the Git repository you want to uninstall the hook from:
aicommits hook uninstall
-
Stage your files and commit:
git add <files...> 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"
-
Aicommits will generate the commit message for you and pass it back to Git. Git will open it with the configured editor for you to review/edit it.
-
Save and close the editor to commit!
To retrieve a configuration option, use the command:
aicommits config get <key>
For example, to retrieve the API key, you can use:
aicommits config get OPENAI_KEY
You can also retrieve multiple configuration options at once by separating them with spaces:
aicommits config get OPENAI_KEY generate
To set a configuration option, use the command:
aicommits config set <key>=<value>
For example, to set the API key, you can use:
aicommits config set OPENAI_KEY=<your-api-key>
You can also set multiple configuration options at once by separating them with spaces, like
aicommits config set OPENAI_KEY=<your-api-key> generate=3 locale=en
Required
The AI API key. You can retrieve it from AI API Keys page.
Default: en
The locale to use for the generated commit messages. Consult the list of codes in: https://wikipedia.org/wiki/List_of_ISO_639-1_codes.
Default: 1
The number of commit messages to generate to pick from.
Note, this will use more tokens as it generates more results.
Set a HTTP/HTTPS proxy to use for requests.
To clear the proxy option, you can use the command (note the empty value after the equals sign):
aicommits config set proxy=
Default: gpt-3.5-turbo
The Chat Completions (/v1/chat/completions
) model to use. Consult the list of models available in the AI Documentation.
Tip: If you have access, try upgrading to
gpt-4
for next-level code analysis. It can handle double the input size, but comes at a higher cost. Check out AI's website to learn more.
The timeout for network requests to the AI API in milliseconds.
Default: 10000
(10 seconds)
aicommits config set timeout=20000 # 20s
The maximum character length of the generated commit message.
Default: 50
aicommits config set max-length=100
Default: ""
(Empty string)
The type of commit message to generate. Set this to "conventional" to generate commit messages that follow the Conventional Commits specification:
aicommits config set type=conventional
You can clear this option by setting it to an empty string:
aicommits config set type=
This CLI tool runs git diff
to grab all your latest code changes, sends them to AI'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.
-
Hassan El Mghari: @Nutlope
-
Hiroki Osame: @privatenumber
If you want to help fix a bug or implement a feature in Issues, checkout the Contribution Guide to learn how to setup and test the project