# gitmoji

An emoji guide for your commit messages. 😜

Repository: https://github.com/carloscuesta/gitmoji
Canonical: https://ross.abutalabs.com/products/gitmoji
Homepage: https://gitmoji.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: emoji, gitmoji, commits
Last push: 2026-08-01T04:05:02+00:00
Link (homepage): https://gitmoji.dev
Link (site_page): https://gitmoji.dev/about

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 8, longevity 100
- inputs: {"age_days": 3603, "days_push": 32, "days_rel": 539, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 16787, forks 820 (observed 2026-08-28T04:11:17.270284+00:00)

## What it is
Gitmoji is a standardized guide and cheatsheet for using emojis in Git commit messages to convey the intent of each change at a glance. It includes an interactive command-line client (gitmoji-cli) and an npm package of the emoji definitions for programmatic use.

## Use cases
- standardize emoji usage in commit messages across a team
- interactively pick an emoji when writing a commit from the terminal
- identify the purpose of a commit at a glance in git log
- use gitmoji definitions as a dependency in commit linting tools
- adopt a visual commit message convention instead of conventional commits

## When to choose
- you want a lightweight, well-known emoji convention for commit messages
- your team prefers visual commit intent markers over verbose prefixes
- you want an interactive CLI to build commit messages
- you need a machine-readable list of commit emojis for tooling

## When to avoid
- your project requires strict conventional-commits compliance for semantic versioning
- your tooling or CI cannot handle emojis in commit messages
- you prefer plain-text commit conventions like Angular-style prefixes

## Facets
- artifact type: cli-tool
- maturity: stable
- function: developer-tools, cli, documentation
- domain: developer-tools, version-control
- platform: cli, cross-platform
- tags: gitmoji, emoji, commit-messages, git, conventional-commits, npm-package, command-line, nodejs

## Member repositories
- carloscuesta/gitmoji (main) score 66
- carloscuesta/gitmoji-cli (plugin) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:17.270284+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:04:15.613951+00:00, confidence not recorded.
  - readme: https://github.com/carloscuesta/gitmoji (fetched 2026-08-28T04:11:17.270284+00:00, sha 9bdbe71bda7f)
  - homepage: https://gitmoji.dev (fetched 2026-08-29T08:02:27.439839+00:00, sha 590ed8e8abf5)
  - site_page: https://gitmoji.dev/about (fetched 2026-08-29T08:02:27.449075+00:00, sha 25e42cbcf55d)
  - registry_npm: https://registry.npmjs.org/gitmoji-cli (fetched 2026-08-29T08:02:27.451196+00:00, sha 1224430b9aad)
- Data as of 2026-08-30T08:39:29.467469+00:00.