Command-line interface tool that helps enforce standardized commit message formats in Git repositories.

• Standardized Commit Messages: Enforce consistent commit message structure by guiding users through prompts and validating against specified formats.
• Conventional Commit Support: Easily generate commit messages following popular commit conventions like Conventional Commits.
• User-Friendly Interface: Interactive prompt-based interface for creating compliant commit messages without worrying about format details.
• Integration with Git: Seamlessly commit changes directly from the CLI, ensuring compliance with the chosen commit message convention.
• Emoji Support: Add emojis to your commit messages to express the nature of the changes or provide additional context.
• Ticket Support: Set ticket reference to your commit messages to link directly the changes with your task.
• Specific Pattern: Commit pattern is flexible and customisable to provide a better commit message convention.
• Configuration Support: Get or Set specific configuration like pattern config.

To install commitizen-cli, use:

npm install -g commitizen-cli

or if you don't like to install it globaly, use:

npx commitizen-cli

Navigate to your Git repository.

Run the following command:

commitizen-cli

or use the minified command:

cocli

List of type available:

• feature ✨
• bugfix 🐛
• hotfix 🚑
• chore 🛠️
• epic 📌
• design 🎨
• experiment 🧪
• documentation 📝

Pattern is defined like this: <type>(<ticket>): <commit>

• <type>: Type of commit (feature, bugfix, documentation, ...)
• <ticket>: Reference of ticket (if ticket is defined)
• <commit>: Commit message

Example: design(XXX-000): implement responsive design

But <ticket> is an optional pattern, you can set it to false on prompt and the default pattern is like this: <type>: <commit>

Example: feature: implement new chat system on the frontend

And <emoji> is an optional pattern too, if you like to make your commit cool you can check the use emoji prompt and define custom pattern with <emoji>, like this:

• if you have <ticket> reference: <emoji> <type>(<ticket>): <commit>: 📝 documention(XXX-000): creating new docs on the package
• or not: <emoji> <type>: <commit>: 📝 documention: creating new docs on the package

Get or Set configuration directly to save specific config, use:

commitizen-cli config get PATTERN

commitizen-cli config set PATTERN='specific pattern'

or using the minified command:

cocli config get PATTERN

cocli config set PATTERN='specific pattern'

To update to the latest version, use:

commitizen-cli update

or using the minified command:

cocli update

Follow the prompts to generate a standardized commit message.

The CLI will execute the Git command to commit your changes with the generated message.

Commitizen CLI is an MIT-licensed open source project. It can grow thanks to the sponsors and support.

Commitizen CLI is MIT licensed.