AI commit messages that actually handle what goes wrong.

Runs your pre-commit checks, turns failures into error reports your coding agent can act on, and writes a conventional commit message for each group of changes. No OpenAI required.

Get Started View on GitHub

cmint

$ cmint -a
⠋ Analyzing staged changes...
✓ Grouped 8 files into 3 commits
─── Commit 1/3 ───────────────────────
feat(auth): add OAuth2 PKCE flow for Google provider
   src/auth/google.ts, src/auth/pkce.ts, tests/auth.test.ts
─── Commit 2/3 ───────────────────────
fix(api): handle 429 rate limit with exponential backoff
   src/api/client.ts, src/api/retry.ts
─── Commit 3/3 ───────────────────────
docs(readme): update quickstart with cmint config steps
   README.md, docs/setup.md, CHANGELOG.md
✓ 3 commits created successfully

Built for how commits actually work

Not just another AI wrapper. commit-mint understands your staging area, your hooks, and your workflow.

Auto-groups by intent

10 changed files across 3 concerns? commit-mint splits them into separate commits, each with its own focused message.

Hook failure recovery

When biome, tsc, vitest, or eslint fails — get a structured error report you can copy to clipboard and paste straight into a coding agent. Skip the hook, restage, edit, or cancel.

Pre-flight checks

lint-staged-compatible checks in .cmintrc that run after staging but before the AI call. Already using lint-staged? Rename your config and go.

No OpenAI required

Works with Groq, Cerebras, and Mistral out of the box. Bring your own API key, pick the provider that fits your budget.

AI agent mode

cmint --agent runs non-interactively with JSON output — auto-group, generate, and commit from any coding agent. No TUI, no prompts.

Conventional commits

Every message follows the Conventional Commits spec. feat, fix, docs, chore — properly scoped and formatted.

Up and running in 60 seconds

Three commands. No accounts to create, no dashboards to configure.

Install

Install globally via npm, or run once with npx. Requires Node.js 18+ and git.

              $ npm install -g @kyubiware/commit-mint

              # or run without installing:

              $ npx @kyubiware/commit-mint

Configure

Run the interactive setup. Pick your AI provider and paste your API key.

$ cmint config

Commit

Stage your changes and let commit-mint do the rest. Use -a to auto-stage everything.

              $ cmint -a

              # or stage manually, then:

              $ cmint

How it compares

commit-mint vs other commit message tools.

Feature	commit-mint	aicommits	opencommit	cz-git	commitizen
AI-generated messages	✓	✓	✓	—	—
Auto-group by intent	✓	—	—	—	—
Hook failure recovery	✓	—	—	—	—
Pre-flight checks	✓	—	—	—	—
lint-staged-compatible config	✓	—	—	—	—
AI agent mode (JSON output)	✓	—	—	—	—
Multiple AI providers	✓	—	✓	—	—
Cached retries	✓	—	—	—	—
Conventional commits	✓	✓	✓	✓	✓
Open source (MIT)	✓	✓	✓	✓	✓