ai-conventional-commit-cli

🎨 Styles & Gitmoji

Switch between standard Conventional Commits and gitmoji modes, and let the CLI learn your repo's style.

The CLI supports three commit styles out of the box. Set the active style via the AICC_STYLE environment variable, the style config key, or the --style flag for a single run.

😀 Gitmoji modes

ModeExample outputNotes
standardfeat: add search boxNo emoji
gitmoji✨ feat: add search boxEmoji prefix, type retained
gitmoji-pure✨: add search boxEmoji prefix, type removed

🔧 Per-run override

AICC_STYLE=gitmoji ai-conventional-commit
# ✨ feat(ui): add dark mode toggle

Or with the flag:

ai-conventional-commit --style gitmoji-pure

🧠 Style learning

Beyond the chosen mode, the CLI builds a style fingerprint from your recent commit history — capturing scope conventions, capitalisation, and phrasing — so generated messages match the surrounding history rather than a generic template. The number of recent commits sampled is controlled by the styleSamples config key (default 120).

On this page