better-commit

TypeScript-first conventional commits from a single commit.config.ts — composable plugins, optional AI, and the same rules in CI.

better-commit helps you and your AI tools ship consistent commit messages without juggling ad hoc scripts. One config file, one CLI (bc / better-commit), and you are productive in minutes.

Quick Start

npm install -D @better-commit/cli
bc init
bc

bc runs the interactive commit flow. Use bc doctor to verify Node, config load, plugins, and AI providers. Non-interactive bc init supports -q; add -f to replace an existing file.

What you get

• conventionalCommits — Allowed types and optional scopes; drives validation in bc check.
• defineConfig + plugins — Compose conventionalCommits (required) and optional aiSuggest for message suggestions.
• bc check — Validate the last message, COMMIT_EDITMSG, or a ref range — same rules as locally, ideal for CI.

Key Features

⚡ Interactive first

bc and bc commit guide the message; bc fix amends the last commit; bc retry reuses cached form data when you need another try.

🎯 One config file

Discovery walks up for commit.config.ts, commit.config.mts, or commit.config.js. Import helpers from @better-commit/cli/config for typed, small surface area.

🤖 AI-ready, not AI-required

Optional aiSuggest plugs into Cursor, Claude, Codex, OpenAI, Anthropic, and more. Use --no-ai or BETTER_COMMIT_NO_AI=1 for fully manual flows.

🏗️ CI and hooks

Run bc check in pipelines; wire exec bc commit in Husky prepare-commit-msg so local commits match automation.

---

Install @better-commit/cli from npm. For flags, bc check modes, AI providers (bc doctor), and security notes, see the repository and package source.