🐶 Git hooks made easy
Latest commit 49905b0 Oct 16, 2017 @typicode typicode Update README.md
Failed to load latest commit information.
__tests__ fix Sep 29, 2017
bin fix Sep 29, 2017
src fix Sep 29, 2017
.gitignore First commit Jun 23, 2014
.npmignore Add .npmignore (#127) May 23, 2017
.travis.yml Update travis test (#149) Jun 30, 2017
CHANGELOG.md Update CHANGELOG.md Aug 30, 2017
HOOKS.md Add sendemail-validate githook (#173) Aug 30, 2017
LICENSE First commit Jun 23, 2014
README.md Update README.md Oct 16, 2017
appveyor.yml 0.14 (#142) Jun 22, 2017
package-lock.json fix Sep 29, 2017
package.json 0.14.3 Jul 5, 2017


husky npm version Mac/Linux Build Status Windows Build status

Git hooks made easy

Husky can prevent bad commit, push and more 🐶 woof!

New beta version available here. Feedback and bug reports welcome 😉


npm install husky --save-dev
yarn add husky --dev
// Edit package.json
  "scripts": {
    "precommit": "npm test",
    "prepush": "npm test",
    "...": "..."
git commit -m "Keep calm and commit"

Existing hooks aren't replaced and you can use any Git hook.

If you're migrating from ghooks, simply run npm uninstall ghooks --save-dev && npm install husky --save-dev and edit package.json. Husky will automatically migrate ghooks hooks.

Used by


npm uninstall husky
yarn remove husky


Debug hooks easily

If you need to debug hooks, simply use npm run <script-name>. For example:

npm run precommit

Git GUI clients support

If you've installed Node using the standard installer, nvm or homebrew, Git hooks will be executed in GUI applications.

Working with multiple version of Node

If nvm is installed, husky will try to use the default/current installed Node version or use the project .nvmrc.

Tip to use the system-installed version of node, nvm provides a system alias

Accessing Git params

Git params can be found in GIT_PARAMS environment variable.

Setting a different log level

By default, husky will run scripts using --silent to make the output more readable. If you want to override this, simply pass a different log level to your scripts:

"precommit": "npm run some-script -q"

-q/--quiet is equivalent to --loglevel warn which is npm default log level.

Git submodule and subtree support


Cygwin support


Yarn support

Please use yarn v0.24+

See also


MIT - Typicode 🌵 - Patreon