1.2.2 • Public • Published

Build Status Code Climate Turbo Commit npm bitHound codecov

Turbo Git

This CLI tool was originally thought for implementing the Turbo Commit Convention easily. Now It's more than that.. You can use it with any other commit convention just choosing one with an utility command. And it's also good for tuning out of the box git commands.

If you enjoy the good quality software and you work hard for have it, You'll enjoy using a commit convention on your projects that ensures readability and understanding. You can also make some greats improvements on how you use git in the command line everyday. Wouldn't it be great to have a tool that ensure all of this for you and for your team?


npm install -g turbo-git

Hurrah! Now you're able to use the turbo commands! 🎉🙌

Demo (outdate)

Available Commands

Turbo command Git Alias Desciption
turbo init git ti Init command, set a commit convention for a git repository.
turbo commit git tc Execute a turbo commit using a convention.
turbo log git tl Show the turbo log, git log with colors according your convention
turbo add git ta Turbo add, utility for execute a git add is a easier way.
turbo diff git td [options] Turbo diff, improved diff using diff-so-fancy

Note: The turbo command will work also from git: git turbo <command>

How to use

This is an example using the Turbo Commit Convention.

First, add something to commit you can use turbo add or our git ta as well. You will be prompted with the following:


Select what you want to add by moving with the arrow key and pressing space.. then enter.

Now you are able to do a Turbo Commit with the command git tc as follows:

git tc

After that, you'll see the possible tags for your turbo-commits:


Choose the tag to wrap your commit message, press enter. Now insert your commit title and the optional description and you're done.

Congrats! You did your first Turbo Commit. 😎

Now, you can see it in your Turbo Log. Executing git tl you will se the git log with the corresponding commit color.


Now you have a semantic git log 😎🙌

Commit Conventions

If you want Turbo Git allows you work with any other commit convention. We provide some of them with the turbo init command and you can create one by your own in an easy way. You are able also to use different conventions per git repository that's what the .turbogit file exactly does. You can create the .turbogit as follow:

git turbo init

or just

git ti

You will see the following options:

  • Turbo Commit
  • Angular
  • Open UI5
  • Custom

You can choose whatever you want.. and this init command will create a .turbogit file on your repo. The .turbogit file.. It's just a json that you can easilly edit to your needs.

The Custom option is not doing to much at the moment. It's just creating the .turbogit file with some explanations about how to edit it.

Coming soon

  • Turbo changelog command, for autogenerate changelogs based on any commit convention.

  • Improvements in the existing turbo commands adding functionalitty and a beter UX.

  • We'll continue working on add new turbo-commands that will have some extra magic, any idea/help is welcome.

Convention Badge

If you choose use the Turbo Commit Convention Be proud like we are.. add the Badge to your projects 😁

Turbo Commit: On


[![Turbo Commit](https://img.shields.io/badge/Turbo_Commit-on-3DD1F2.svg)](https://github.com/labs-js/turbo-git/blob/master/README.md)


<a href="https://github.com/labs-js/turbo-git/blob/master/README.md"><img src="https://img.shields.io/badge/Turbo_Commit-on-3DD1F2.svg" alt="Turbo Commit: On"/></a>

Related Projects

These packages were created for make turbogit posible:

And thanks to these great projects that we use a lot:

Package Sidebar


npm i turbo-git

Weekly Downloads






Unpacked Size

50.7 kB

Total Files


Last publish


  • sfabrizio
  • alancampora