Prevents bad commit or push (git hooks, pre-commit/precommit, pre-push/prepush, post-merge/postmerge and all that stuff...)
Last updated 8 months ago by forivall .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @forivall/husky 
SYNC missed versions from official npm registry.


Next release you can support the development of v4 major release on Open Collective and GitHub Sponsors ????


Financial Contributors on Open Collective Mac/Linux Build Status Windows Build status

Git hooks made easy

Husky can prevent bad git commit, git push and more ???? woof!


npm install husky --save-dev
// package.json
  "husky": {
    "hooks": {
      "pre-commit": "npm test",
      "pre-push": "npm test",
      "...": "..."
git commit -m 'Keep calm and commit'

To go further, see the docs here.


npm uninstall husky

Git hooks installed by husky will be removed.

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]



Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]


Husky requires Node >= 8.6.0 and Git >= 2.13.2

Upgrading from 0.14

Simply move your existing hooks to husky.hooks field and use raw Git hooks names. Also, if you're using the GIT_PARAMS env variable, rename it to HUSKY_GIT_PARAMS.

  "scripts": {
-   "precommit": "npm test",
-   "commitmsg": "commitlint -E GIT_PARAMS"
+ "husky": {
+   "hooks": {
+     "pre-commit": "npm test",
+     "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
+   }
+ }

Alternatively, you can run the following command which will do the same automatically for you ;)


Starting with 1.0.0, you can also configure hooks using .huskyrc, .huskyrc.json or .huskyrc.js file.

// .huskyrc
  "hooks": {
    "pre-commit": "npm test"

To view the full list of changes, please see the CHANGELOG.


  • Keeps existing user hooks
  • Supports GUI Git clients
  • Supports all Git hooks (pre-commit, pre-push, ...)

Used by

See also

  • pkg-ok - Prevents publishing a module with bad paths or incorrect line endings
  • please-upgrade-node - Show a message to upgrade Node instead of a stacktrace in your CLIs
  • pinst - dev only postinstall hook


People and companies supporting via Patreon: thanks



Current Tags

  • 3.1.1-skipInstall                                ...           latest (8 months ago)
  • 3.1.1-skipInstall                                ...           skipInstall (8 months ago)

2 Versions

  • 3.1.1-skipInstall                                ...           8 months ago
  • 3.1.0-skipInstall                                ...           10 months ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 2
Dependencies (11)
Dev Dependencies (24)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |