A Claude Code plugin that analyses your git changes and creates conventional commits with gitmoji — with optional GPG signing.
- Auto-analyses staged and unstaged changes via
git status+git diff - Generates Conventional Commits messages with gitmoji
- Optional GPG signing (pass your passphrase, or omit for unsigned commits)
- References recent commit history to match your project's style
Add to your project .claude/settings.json or global ~/.claude/settings.json:
{
"plugins": [
"https://github.com/root-hbx/claude-cmt-plugin"
]
}# Unsigned commit
/cmt
# GPG-signed commit
/cmt <your-gpg-passphrase>
<emoji> <type>(<scope>): <short description>
| Type | Emoji | Type | Emoji |
|---|---|---|---|
| feat | ✨ | chore | 🔧 |
| fix | 🐛 | revert | ⏪ |
| docs | 📝 | wip | 🚧 |
| style | 💄 | breaking | 💥 |
| refactor | ♻️ | security | 🔒 |
| perf | ⚡️ | deps | ⬆️ |
| test | ✅ | remove | 🔥 |
| build | 📦 | move | 🚚 |
| ci | 👷 | release | 🔖 |
Compared with the built-in /commit command in Claude Code:
| Feature | /commit (built-in) |
/cmt (this plugin) |
|---|---|---|
| Gitmoji prefix | ❌ Not supported | ✅ 20+ types auto-mapped |
| Conventional Commits | ❌ Free-form, no enforced spec | ✅ Strict v1.0.0 compliance |
| Scope annotation | ❌ Not required | ✅ Always annotates change scope |
| GPG signing | ❌ Not supported | ✅ Optional, pass passphrase to enable |
| GPG agent warm-up | ❌ N/A | ✅ Auto warm-up, no interactive prompt |
| Co-Authored-By tag | ❌ Not added, cleaner commit history | |
| Commit format consistency | ✅ Fixed template <emoji> <type>(<scope>): <desc> |
MIT