# Install gitmoji with Homebrew Interactive command-line tool for using emoji in commit messages. Version 9.7.0 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:gitmoji ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gitmoji ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:gitmoji - **Package manager:** Homebrew - **Package manager page:** - **Version:** 9.7.0 - **Source summary:** Interactive command-line tool for using emoji in commit messages - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-25T07:20:51+00:00 ## Executables - gitmoji (cli) - gitmoji (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-25 - Package-manager version: 9.7.0 - Local data: ok - Upstream repository: https://gitmoji.dev - info: No package-manager update timestamp was available. - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage gitmoji-cli is the command-line companion to Gitmoji, Carlos Cuesta's emoji guide for commit messages. The CLI turns the guide into an interactive commit workflow, searchable emoji catalog, commit hook, and local configuration system. ### Project history The Gitmoji guide repository was created in October 2016 to standardize and explain emoji usage in GitHub commit messages. The gitmoji-cli repository followed in November 2016 as an interactive client for using those symbols from a terminal. The CLI grew around practical commit-message tasks: searching the Gitmoji catalog, listing available entries, initializing a commit hook, creating commits through prompts, and caching the emoji list for offline use. Its configuration supports package.json and .gitmojirc.json so projects can choose emoji format, prompts, scopes, and catalog URL. ### Adoption history Gitmoji became a recognizable developer-experience convention because the guide is easy to display in READMEs and the CLI made the convention usable without memorizing the catalog. The guide repository has substantial GitHub stars, and the CLI is distributed through npm and Homebrew. The npm package history begins in November 2016 and spans many published versions, reflecting a JavaScript-tooling distribution model where the CLI can be installed globally and used across repositories. ### How it is used Practitioners use gitmoji-cli to search for an intention, create an interactive commit, or install a commit hook that prompts for an emoji during git commit. Teams that prefer text tokens can configure code-style output, while teams that prefer visual logs can use raw emoji. The tool is often paired with Conventional Commits-style scopes or project-specific commit guidelines, giving a lightweight visual layer over release notes and history scanning. ### Why package nerds care gitmoji-cli is notable because the Homebrew formula name gitmoji points to a Node CLI whose upstream package is gitmoji-cli. It is a small example of package identity drift between a convention, its website, its data package, and the executable users install. ### Timeline - 2016: The carloscuesta/gitmoji guide repository was created. - 2016: The carloscuesta/gitmoji-cli repository and npm package were created. - 2018: README examples showed hook, search, list, update, and configuration workflows. - 2025: The 9.x release line continued the CLI's maintenance stream. ### Related projects - carloscuesta/gitmoji provides the guide and emoji catalog used by the CLI. - The gitmojis npm package publishes the emoji data for dependency use. ### Sources - - - - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: package.json, .gitmojirc.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gitmoji - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [commitlint](https://www.automicvault.com/pkg/brew/commitlint/) - Shares av.db curated category or tags: cli, commit-messages, developer-tools, git. - [gitlint](https://www.automicvault.com/pkg/brew/gitlint/) - Shares av.db curated category or tags: cli, commit-messages, developer-tools, git. - [all-repos](https://www.automicvault.com/pkg/brew/all-repos/) - Shares av.db curated category or tags: cli, developer-tools, git. - [b4](https://www.automicvault.com/pkg/brew/b4/) - Shares av.db curated category or tags: cli, developer-tools, git. - [bat](https://www.automicvault.com/pkg/brew/bat/) - Shares av.db curated category or tags: cli, developer-tools, git. - [bazel-diff](https://www.automicvault.com/pkg/brew/bazel-diff/) - Shares av.db curated category or tags: cli, developer-tools, git. - [bfg](https://www.automicvault.com/pkg/brew/bfg/) - Shares av.db curated category or tags: cli, developer-tools, git. - [bit-git](https://www.automicvault.com/pkg/brew/bit-git/) - Shares av.db curated category or tags: cli, developer-tools, git. - [czg](https://www.automicvault.com/pkg/brew/czg/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, commit, developer, developer-tools, git. - [devmoji](https://www.automicvault.com/pkg/npm/devmoji/) - Local package facts share a topical domain. Shared terms: cli, command-line, commit, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/gitmoji.yml](https://github.com/automic-vault/db/blob/main/combined/gitmoji.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph