Gitmoji is a visual vocabulary for commit messages. It makes git logs more colourful and informative.

Asking Claude straight to “use gitmoji” in commit messages will give weak results as you would expect: incorrect uses and hallucinated gitmojis. In earlier tries, I converted the full gitmoji json to plain text (fewer tokens for the same content), had the agent read it after composing the commit message, and select the gitmoji. It was slowish, took one turn and some thinking, and the results were all individually correct, but lacked consistency.

By reducing the vocabulary to conventional commit, you get more consistent logs, and help for semantic versioning: fix only → patch, feat → minor, breaking → major. And you can rely on Claude training to give good results spontaneously, or with minimal direction (“use conventional commit notation”), no tool call, and no thinking.

What this plugin does: it installs a git hook that rewrites a conventional commit prefix type[(scope)][!] into <gitmoji>[💥][scope:]. [x] means optional x. If the commit message does not match either the conventional commit template or the gitmoji template (for idempotence), error out with a list of allowed commit types. See the complete table.

That’s it, just a SessionStart hook that installs a git commit-msg hook, or complains if another one is already present. And it gives you gitmojis.

Install:

/plugin marketplace add ddaanet/claude-plugins
/plugin install gitmoji@ddaanet

Github home page