Conventional Commits Linter

The Conventional Commits Linter is a free browser-based tool that validates your Git commit messages against the Conventional Commits specification. Conventional Commits is a lightweight convention on top of commit messages that provides a structured format: a type, an optional scope, a description, an optional body, and optional footers. This structure makes commit histories easier to read, enables automated changelog generation, and integrates cleanly with semantic versioning.

This linter parses each commit message and checks it against a configurable set of rules. It validates that the commit starts with a recognized type (feat, fix, docs, chore, etc.), that an optional scope is enclosed in parentheses, that the type is followed by a colon and a space, and that the description is non-empty. It also checks subject line length (default maximum of 72 characters), body line length (maximum 100 characters), breaking change markers (! or BREAKING CHANGE footer), and footer format (key: value or key #value).

You can customize the tool to match your project's needs. Add custom commit types beyond the standard set, adjust the maximum subject line length with a slider, and enable or disable individual rules. The bulk mode lets you paste multiple commit messages separated by --- and validate them all at once, with a summary showing how many pass and how many fail.

If you work with Git regularly, you may also find the Git Command Builder helpful for constructing complex Git commands, or the .gitignore Generator for creating ignore files. For comparing code changes before committing, try the Diff Viewer.

All processing happens entirely in your browser. Your commit messages are never sent to any server. There are no API calls, no logging, and no third-party services involved. This makes it safe to validate commit messages containing sensitive information such as internal project names or ticket references.

1. Paste one or more commit messages into the Commit Message(s) textarea on the left.
2. View the real-time validation results in the right panel. Each rule shows a green check, red X, or yellow warning.
3. To validate multiple commits at once, separate them with a --- line. A Bulk Summary will appear showing pass/fail counts.
4. Click Options to expand the settings panel. Adjust the Max subject line length slider (default 72).
5. Add Custom allowed types by typing comma-separated values (e.g., wip, hotfix, release) to extend the default type list.
6. Toggle individual rules on or off using the checkboxes under Enable / disable rules.
7. If a fix suggestion is available, click Copy corrected to copy the auto-fixed message. Press Ctrl+Shift+C to copy the original input.