#chatgpt #commit #commit-message #cli #command-line

app turbocommit

A CLI tool to create commit messages with gpt-3.5-turbo

29 releases (10 breaking)

0.11.2 Apr 23, 2023
0.10.1 Apr 18, 2023
0.8.4 Mar 29, 2023

#3 in #commit-message

Download history 17/week @ 2023-02-27 193/week @ 2023-03-06 97/week @ 2023-03-13 75/week @ 2023-03-20 129/week @ 2023-03-27 77/week @ 2023-04-03 48/week @ 2023-04-10 173/week @ 2023-04-17 45/week @ 2023-04-24 20/week @ 2023-05-01 74/week @ 2023-05-08 10/week @ 2023-05-15 7/week @ 2023-05-22

112 downloads per month

MIT license



Crates.io Crates.io Crates.io

turbocommit is a CLI tool written in Rust that generates commit messages in accordance with the Conventional Commits specification. It uses the git diff to create commit messages that accurately reflect the changes made to a repository.


turbocommit can be easily installed with Cargo, Rust's package manager. Simply run the following command:

cargo install turbocommit

Please note that in order to use turbocommit, you will need to set the OPENAI_API_KEY environment variable. This API key is required to use the OpenAI gpt-3.5-turbo language model, which is used by turbocommit to generate commit messages.


When you have staged some changes, you can run the turbocommit (I recommend making a tc symlink)

Generating Conventional Commits with turbocommit

Short Long Description Default
-n Number of choices to generate 1
-m --model Model to use gpt-3.5-turbo
-d --dry-run Dry run. Will not ask AI for completions
-p --print-once Will not print tokens as they are generated
-t Temperature (t |0.0 < t < 2.0|) 1.0
-f Frequency penalty (f |-2.0 < f < 2.0|) 0.0

Handling Long git diff

In some cases, the git diff for staged changes may be too long to fit within the 4096-token limit enforced by the language model, which turbocommit uses to generate commit messages. When this happens, turbocommit will prompt you with a message indicating that the git diff is too long.

To address this, turbocommit provides a list of all staged files and ask you to select any number of them. The tool will then generate a new git diff that includes only the changes from the selected files. If the resulting git diff plus the system prompt is still too long, turbocommit will repeat the process until the git diff is short enough to be processed by the AI model.

This allows you to generate conventional commit messages with turbocommit while ensuring that the git diff is short enough to be processed by the AI model.

Getting Help with turbocommit

To get help with using turbocommit, you can use the -h or --help option

$ turbocommit --help

This will display the help message with information on how to use the tool.


~671K SLoC