Skip to content
This repository

A slightly improved pre-commit hook for git

A better pre-commit hook for git.

Current version Code Climate Coverage Status Build status Dependency Status Documentation


Install the gem

$ gem install pre-commit

Use the pre-commit command to generate a stub pre-commit hook

# In your git repo
$ pre-commit install

This creates a .git/hooks/pre-commit script which will check your git config and run checks that are enabled.

Available checks

These are the available checks:

  • white_space
  • console_log
  • debugger
  • pry
  • tabs
  • jshint
  • js_lint
  • closure_syntax_check
  • php (Runs php -l on all staged files)
  • rspec_focus (Will check if you are about to check in a :focus in a spec file)
  • ruby_symbol_hashrockets (1.9 syntax. BAD :foo => "bar". GOOD foo: "bar")
  • local (executes config/pre-commit.rb with list of changed files)
  • merge_conflict (Will check if you are about to check in a merge conflict)
  • migrations (Will make sure you check in the proper files after creating a Rails migration)
  • ci (Will run the pre_commit:ci rake task and pass or fail accordingly)
  • rubocop (Check ruby code style using the rubocop gem. Rubocop must be installed)
  • before_all (Check your RSpec tests for the use of before(:all))
  • coffeelint (Check your coffeescript files using the coffeelint gem.)
  • go (Runs go fmt on a go source file and fail if formatting is incorrect, then runs go build and fails if can't compile)
  • scss_lint (Check your SCSS files using the scss-lint gem)
  • yaml (Check that your YAML is parsable)
  • json (Checks if JSON is parsable)

Default checks

Use pre-commit list to see the list of default and enabled checks and warnings.

Enabling / Disabling Checks / Warnings

Git configuration

git config pre-commit.checks "whitespace, jshint, debugger"

To disable, simply leave one off the list

git config pre-commit.checks "whitespace, jshint"

CLI configuration

pre-commit <enable|disable> <git|yaml> <checks|warnings> check1 [check2...]

The git provider can be used for local machine configuration, the yaml can be used for shared project configuration.

Example move jshint from checks to warnings in yaml provider and save configuration to git:

pre-commit disable yaml checks   jshint
pre-commit enable  yaml warnings jshint
git add config/pre-commit.yml
git commit -m "pre-commit: move jshint from checks to warnings"

Example config/pre_commit.yml:

:warnings_remove: []
- :jshint
- :tabs

Configuration providers

pre-commit comes with 4 configuration providers:

  • default - basic settings, read only
  • git - reads configuration from git config pre-commit.*, allow local update
  • yaml - reads configuration from /etc/pre-commit.yml, $HOME/.pre-commit.yml and config/pre-commit.yml, allows config/pre-commit.yml updates
  • env - reads configuration from environment variables


Something went wrong with that request. Please try again.