Minimal, opinionated commit message validator
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Shreyas Minocha 53215070de
Disable travis
3 months ago
.github/workflows Add GH workflow 3 months ago
media 0.1.0 1 year ago
src Fix redundant control flow 3 months ago
test Improve test structure and organization 3 months ago
.gitignore Improve test structure and organization 3 months ago
ava.config.js Re-write using typescript 8 months ago
package-lock.json Add GH workflow 3 months ago
package.json 1.0.0 8 months ago Fix markdown 7 months ago
tsconfig.json Change directory structure 8 months ago
usage.txt Update list of features 8 months ago


Build status Npm version License Commit message style

seven-rule-msg in action

Minimal, opinionated commit message validator.


All rules are inspired from Chris’ post and its predecessors.

  1. Separate subject from body with a blank line
  2. Limit the subject line to 50 characters
  3. Capitalize the subject line
  4. Do not end the subject line with a period
  5. Use the imperative mood in the subject line (not checked)
  6. Wrap the body at 72 characters
  7. Use the body to explain what and why vs. how (not checked)


  • No configuration required
  • Beautiful output
  • Read from $1
  • Read from file
  • Read from STDIN
  • Verbose mode
  • Silent mode

Comparison with other tools

Feature seven-rule-msg commitlint node-commit-msg
Ability to test for seven rules
Designed to test for seven rules
Beautiful output
Easy installation
Zero setup
Does one thing (and does it well)
Checks for imperative tense 1 ⚠️ 2 ⚠️ 3

1 Programmatically checking for imperative tense is non-trivial and error-prone

2 Deprecated

3 Requires separate installation of Java 8


Assuming you have npm installed,

npm install --global seven-rule-msg-cli


From CLI

See also: usage.txt.

CLI Argument

seven-rule-msg 'Fix all the stuff'


seven-rule-msg [--file|-f] <path-to-file>


echo 'Fix all the stuff' | seven-rule-msg

As git hook



seven-rule-msg -f "$1"

Using the node.js API

import validate from 'seven-rule-msg';

const results = validate('A nice lil commit message');

validate(commitMessage: string)

  • Return value: Result[]
    • Length: 7

The ith element of the returned array corresponds to the i + 1th rule.

interface Result {
    readonly rule: Rule,
    readonly type: ResultType
interface Rule {
    readonly message: string,
    readonly test?: (commitMessage: string) => boolean;

Rules without test methods are informative only. In other words, they cannot be reliably checked programmatically.

enum ResultType {
    pass = 'pass',
    fail = 'fail',
    info = 'info'


Here’s a badge to show the world that you follow the seven rules of commit messages.

[![Commit message style](](


Licensed under the MIT License.