Gitmoji Cli

A gitmoji interactive command line tool for using emojis on commits. 💻
Alternatives To Gitmoji Cli
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Gitmoji14,794272 days ago29October 10, 202312mitTypeScript
An emoji guide for your commit messages. 😜
Gitmoji Cli4,39634802 days ago115November 09, 202311mitJavaScript
A gitmoji interactive command line tool for using emojis on commits. 💻
Styleguide Git Commit Message1,001
5 years agootherRuby
Cz Git834298a day ago88December 06, 2023mitTypeScript
cz-git | czg 🛠️ DX first and more engineered, lightweight, customizable, standard output format Commitizen adapter and CLI
Gitlab Emoji126
7 months agoapache-2.0
You love emojis 😄 ? You love Gitlab ?
Gitmoji Commit Hook6923 days ago6December 30, 202211mitJavaScript
Start the commit message with an applicable emoji
Emoji Log Vscode45310 months ago18February 15, 20236mitTypeScript
Emoji-Log VSCode Extension — An Emoji Git commit log messages spec standard. [ 📦👌🐛📖🚀🤖 ‼️]
Emoji Commit40
a year ago11October 12, 20227Rust
Commit Emoji36
9 years ago
List of emoji for git commits. :boom:
Git Emojis Hook32
2 years agobsd-3-clauseShell
Simple git hook to provide strong guidelines for commit message with emojis
Alternatives To Gitmoji Cli
Select To Compare

Alternative Project Comparisons


Build Status Code Climate Codecov npm version npm downloads gitmoji badge


A gitmoji interactive client for using gitmojis on commit messages.


This project provides an easy solution for using gitmoji from your command line. Gitmoji-cli solves the hassle of searching through the gitmoji list. Includes a bunch of options you can play with! 🎉



npm i -g gitmoji-cli


brew install gitmoji


gitmoji --help
A gitmoji interactive client for using gitmojis on commit messages.

    $ gitmoji
    --init, -i      Initialize gitmoji as a commit hook
    --remove, -r    Remove a previously initialized commit hook
    --config, -g    Setup gitmoji-cli preferences.
    --commit, -c    Interactively commit using the prompts
    --list, -l      List all the available gitmojis
    --search, -s    Search gitmojis
    --version, -v   Print gitmoji-cli installed version
    --update, -u    Sync emoji list with the repo


You can use the commit functionality in two ways, directly or via a commit-hook.

If you want to integrate gitmoji-cli in your project I would recommend going for the hook mode as it support more use cases, it's more flexible and has a better integration with other tools, whereas the client mode is more quick and easy to use.


Start the interactive commit client, to auto generate your commit based on your prompts.

gitmoji -c

You can pass default values to the prompts using the following flags:

  • title: For setting the commit title.
  • message: For setting the commit message.
  • scope: For setting the commit scope.

Those flags should be used like this:

gitmoji -c --title="Commit" --message="Message" --scope="Scope"


Run the init option, add your changes and commit them, after that the prompts will begin and your commit message will be built.

gitmoji -i
git add .
git commit

⚠️ The hook should not be used with the gitmoji -c command.

gitmoji commit


Search using specific keywords to find the right gitmoji.

gitmoji -s "criteria"

gitmoji search


Pretty print all the available gitmojis.

gitmoji -l

gitmoji list


Update the gitmojis list, by default the first time you run gitmoji, the cli creates a cache to allow using this tool without internet connection.

gitmoji -u


The cli has some built-in configuration options that you can tweak at your own preference:

  • Automatic git add: Enable or disable the automatic git add . every time you use the commit command.
  • Emoji format: Switch between the emoji format.
  • Message prompt: Enable or disable the message prompt.
  • Scope prompt: Enable or disable conventional commits scope prompt.
  • Gitmojis api URL: Set a custom URL to use it as the library of gitmojis.

You can configure these options via (in order of precedence):

  • A gitmoji key in your package.json file
  • A .gitmojirc.json file.
  • Using the global cli configuration.

If no user configuration is found, a set of default values will be used.


  "gitmoji": {
    "autoAdd": false,
    "emojiFormat": "code | emoji",
    "scopePrompt": false,
    "messagePrompt": false,
    "capitalizeTitle": true,
    "gitmojisUrl": ""


  "autoAdd": false,
  "emojiFormat": "code | emoji" ,
  "scopePrompt": false,
  "messagePrompt": false,
  "capitalizeTitle": true,
  "gitmojisUrl": ""

Local configuration

Run gitmoji -g to setup some gitmoji-cli preferences.

gitmoji config

Popular Commit Projects
Popular Emojis Projects
Popular Version Control Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Command Line Tool