Minimal, opinionated commit message validator
Last updated 10 months ago by shreyasminocha .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install seven-rule-msg 
SYNC missed versions from official npm registry.


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


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.

Current Tags

  • 1.0.0                                ...           latest (10 months ago)

2 Versions

  • 1.0.0                                ...           10 months ago
  • 0.1.0                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 3
Dependencies (6)
Dev Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © |