Comments

- #!/usr/bin/env sh # <- This is deprecated, remove it
- . "$(dirname -- "0ドル")/_/husky.sh" # <- This is deprecated, remove it
### Rest of your hook code

Hooks with these lines will fail in v10.0.0

`v9.1.1`

Compare Source

Super saiyan ~~(削除) god (削除ここまで)~~ dog! It's over 9.0.0!

What's new

You can now run package commands directly, no need for npx or equivalents.
It makes writing hooks more intuitive and is also slightly faster 🐺⚡️

### .husky/pre-commit
- npx jest
+ jest # ~0.2s faster

A new recipe has been added to the docs. Lint staged files without external dependencies (inspired by Prettier docs). Feel free to modify it.

### .husky/pre-commit
prettier $(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') --write --ignore-unknown
git update-index --again

For more advanced use cases, see lint-staged.

Fixes

bunx husky init command
Workaround for some hooks implementation on Windows

Deprecations

#!/usr/bin/env sh and . "$(dirname -- "0ドル")/_/husky.sh" are deprecated. husky command will automatically remove them, no action required.
If you're having code in ~/.huskyrc please move it to .config/husky/init.sh

Support for these will be removed in v10.

Friendly reminder

If Git hooks don't fit your workflow, you can disable Husky globally. Just add export HUSKY=0 to .config/husky/init.sh.

I've seen some confusion about this on X, so just a heads-up!

Sponsoring

Husky is downloaded over 45M times per month and used by ~1.5M projects. If your company wants to sponsor, you can do so here: GitHub Sponsors.

Have a nice summer ☀️ I'm open to new opportunities/consulting so feel free to drop me a message 😉

`v9.1.0`

Compare Source

`v9.0.11`

Compare Source

chore: update package-lock.json by @btea in #1383
fix: export HUSKY=0 in init (fixes #1393) by @typicode in #1395

`v9.0.10`

Compare Source

fix: rename index.d.ts to index.d.mts by @mrkjdy in #1379

`v9.0.9`

Compare Source

refactor: rename files by @typicode in #1378

`v9.0.8`

Compare Source

docs: update index.md by @khaledYS in #1369
Fix tab detection on install command by @glensc in #1376
refactor: reduce file size by @typicode in #1377

`v9.0.7`

Compare Source

fix: typo and source ~/.huskyrc correctly (compatibility with v8)
docs: fix example by @typicode in #1363

`v9.0.6`

Compare Source

docs: add favicon by @rakleed in #1354
chore: apply editorconfig to code only by @typicode in #1355
docs: update install script to mjs and fix CI checks by @starnayuta in #1357
Fix unbound variable by @typicode in #1359

`v9.0.5`

Compare Source

docs: update path to startup files by @ManuelRauber in #1350
fix: init error by @typicode in #1353

`v9.0.4`

Compare Source

fix: init create dir before by @typicode in #1348
refactor: simplify by @typicode in #1349
fix: init not working on pnpm #1334 by @rozbo in #1347

`v9.0.3`

Compare Source

docs: fix link by @typicode in #1340
chore: fix links in issue template by @julien-f in #1341
fix: add scripts field if not present by @chalkygames123 in #1338
docs: changelog link by @typicode in #1343
fix: insert final newline by @chalkygames123 in #1339
fix: fix git hooks path on windows by @rozbo in #1346

`v9.0.2`

Compare Source

fix: exit code by @gergelypap in #1336
docs: typo by @chalkygames123 in #1337

`v9.0.1`

Compare Source

Kicking off the year with an exciting update!

Note: install using husky@latest to get the bug fixes that were released after.

Introducing `husky init`

v8

npm pkg set scripts.prepare="husky install"
npm run prepare
npx husky add .husky/pre-commit "npm test"

v9

Adding husky to a project is now easier than ever. It's just a single line that does the same as above. No need to read the docs to get started anymore.

npx husky init

Adding a New Hook

v8

npx husky add .husky/pre-commit "npm test"
git add --chmod=+x .husky/pre-commit # On Windows

v9

Adding a hook is as simple as creating a file. This can be accomplished using your favorite editor, a script or a basic echo command. For example, on Linux/macOS:

echo "npm test" > .husky/pre-commit

Further Size Reduction

v8 was already the most compact Git hooks manager at approximately 6kB.

v9 takes this a step further, reducing the size to just 3kB, likely making it the smallest devDependency in your toolkit.

To give you an idea of how small it is, the biggest file in the project is the MIT license 😄

More to Come

Additional features are in the pipeline for v9. Stay tuned 🙌

Other Changes

Enhanced security with CI and npm --provenance for safer publishing.
Added $XDG_CONFIG_HOME support. Move ~/.huskyrc to ~/.config/husky/init.sh for centralized configuration.
Fixed permission issue for Windows-created hooks; they no longer need to be executable.
Removed husky install. Use husky or husky some/dir for the same functionality (deprecation notice to be added).
Modified behavior when .git is missing; it now triggers a warning instead of failure.
Replaced HUSKY_DEBUG=1 with HUSKY=2 for debugging.
Updated the Husky API for module usage.
Transitioned to ESM for module usage.
Dropped support for Node 14 and 16.
Revamped docs.

How to Migrate

v9 is backward compatible with v8, allowing you to freely upgrade and migrate your hooks later.

Here are the steps to migrate:

package.json

{
 "scripts": {
- "prepare": "husky install"
+ "prepare": "husky"
 }
}

.husky/pre-commit

- #!/usr/bin/env sh
- . "$(dirname -- "0ドル")/_/husky.sh"
npm test

Note: sh will be used to run hooks, even if a shebang is set.

If you were using husky as a module:

- const husky = require('husky')
- // ...
+ import husky from 'husky'
+ console.log(husky())

`v8.0.3`

Compare Source

fix: add git not installed message #1208

`v8.0.2`

Compare Source

docs: remove deprecated npm set-script

`v8.0.1`

Compare Source

fix: use POSIX equality operator

`v8.0.0`

Compare Source

What's Changed

Feats

feat: add husky - prefix to logged global error messages by @joshbalfour in #1092
feat: show PATH when command not found to improve debuggability
feat: drop Node 12 support
feat: skip install if $HUSKY=0

Fixes

fix: hook script use /usr/bin/env sh instead of direct path of sh by @skhaz in #1051
fix: actually set 'husky_skip_init' as readonly in ./husky.sh by @hyperupcall in #1104
fix: force basename/dirname to treat 0ドル as an argument by @mataha in #1132
fix: remove git.io links by @renbaoshuo in #1136

Docs

docs: fix uninstall via npm by @pddpd in #1033
docs: add dog emoji as favicon by @jamiehaywood in #1095
docs: replace deprecated npx --no-install option with npx --no by @sibiraj-s in #1070
docs: add pnpm installation by @MohamadKh75 in #1139

Chore

chore: update workflows by @tiziodcaio in #1125

`v7.0.4`

Compare Source

No changes. Husky v7.0.3 was reverted, this version is the same as v7.0.2.

`v7.0.3`

Compare Source

`v7.0.2`

Compare Source

Fix pre-commit hook in WebStorm (#1023)

`v7.0.1`

Compare Source

Fix gracefully fail if Git command is not found #1003 (same as in v6)

`v7.0.0`

Compare Source

Improve .husky/ directory structure. .husky/.gitignore is now unnecessary and can be removed.
Improve error output (shorter)
Update husky-init CLI
Update husky-4-to-7 CLI
Drop Node 10 support

Please help me develop and release OSS projects ❤️ on GitHub Sponsors or Open Collective. Thank you for your support!

`v6.0.0`

Compare Source

After being in early access for Open Source projects and Sponsors for a limited time, I'm happy to announce that husky 6 is MIT again and can be freely used in commercial projects! 🎉

Many thanks to the Open Source projects and Companies which have switched to/sponsored the new husky during this period!

OSS is my full-time job, please consider sponsoring the development of husky on GitHub sponsors or Open Collective. Thank you!

Breaking change

husky init has been moved to its own package (npx husky-init)

Added

Programmatically use husky: require('husky')
TypeScript definitions

Migrating from husky 4

Husky 6 contains breaking changes. If you're coming from v4, npm install husky@6 won't be enough.

Recommended: see husky-4-to-6 CLI to automatically migrate your config. There's also a dedicated section in the docs.

If you're curious why config has changed, you may be interested in reading:
https://blog.typicode.com/husky-git-hooks-javascript-config/

Also Husky 6 follows official npm and Yarn best practices regarding autoinstall. It's recommended to use prepare script instead (see usage in docs).

`v5.2.0`

Compare Source

Add set command to replace hooks (husky set .husky/pre-commit cmd)
Update add command to append command (husky add .husky/pre-commit cmd)
Improve error messages

`v5.1.3`

Compare Source

docs: add specific Yarn v2 install/uninstall instructions
cli: husky init will detect Yarn v2 and initialize accordingly

`v5.1.2`

Compare Source

docs: recommend prepare script instead of postinstall (#890)
cli: husky init use prepare script (#890)

`v5.1.1`

Compare Source

style(shell): add trailing newlines (#870)
fix(init): update package.json postinstall

`v5.1.0`

Compare Source

Add husky init

`v5.0.9`

Compare Source

fix(install): do not fail if not inside a Git directory (closes #851)

See https://github.com/typicode/husky/releases/tag/v5.0.0 for v5 release notes

`v5.0.8`

Compare Source

fix(install): better handle Git <2.9 (#846) closes #844

`v5.0.7`

Compare Source

fix(shell): double quote params (#824)

`v5.0.6`

Compare Source

Remove unused files

`v5.0.5`

Compare Source

Fix custom directory support #827

👉 See https://typicode.github.io/husky for breaking changes and new installation instructions.

Note about the license

Husky 5 is released under The Parity Public License.

It doesn't affect you if you're using husky in an Open Source project or if you're a sponsor. You're free to use it as usual and I hope you'll enjoy this new release ❤️

If you're using husky in a commercial project, you may want to consider becoming a sponsor to support the project. You can also try it for 30 days.

This is only for a limited time, husky will be MIT again later.

Migrating

Important Husky v5 brings a lot of improvements but is also very different from v4. Git hooks won't work if you only upgrade husky dependency, existing config needs to be migrated too.

The best way to switch to v5 is to follow the new installation instructions and migrate existing hooks command using husky add.

`v4.3.8`

Compare Source

Fix Cannot read property 'toString' of null
Improve error messages

`v4.3.7`

Compare Source

Fix: upgrade find-versions to 4.0.0 #837

`v4.3.6`

Compare Source

Fix prepare-commit-msg on windows #737

`v4.3.5`

Compare Source

Rollback and do not throw error if husky install fails

`v4.3.4`

Compare Source

Throw error if husky install fails
Add workaround for npm 7 currently missing INIT_CWD environment variable

Add .cjs config file support #754

`v4.2.5`

Compare Source

Fix wrong error message #709
Update dependencies #710

`v4.2.4`

Compare Source

When Node version is unsupported, log actual version in addition to the error message #701
Fix: support cnpm package manager #687
Fix: always use sh to run scripts and avoid inconsistencies #707
Fix: don't throw error if files are already removed during uninstall #708

`v4.2.3`

Compare Source

Fix: check for husky.config.js not .huskyrc.config.js #669

`v4.2.2`

Compare Source

Fix #662 disable fast-skip heuristic for .husky.js and .husky.config.js
Fix do not install update, pre/post-receive hooks

`v4.2.1`

Compare Source

Fix: support spaces in path to husky.local.sh #658

`v4.2.0`

Compare Source

Check Git version during install and log an error if it's <2.13.0

`v4.1.0`

Compare Source

Improve speed and refactor hooks

`v4.0.10`

Compare Source

`v4.0.9`

Compare Source

Fix: read stdin from hook script (#645)

`v4.0.8`

Compare Source

`v4.0.7`

Compare Source

Fix: Yarn when running inside winpty (#634)

`v4.0.6`

Compare Source

Revert change in v4.0.5

`v4.0.5`

Compare Source

Fix: use process.exit if install fails #633

`v4.0.4`

Compare Source

Fix: npm ignore .eslintrc.js (#627)

`v4.0.3`

Compare Source

Fix: error message if trying to install in a non-git repo (#627)

`v4.0.2`

Compare Source

Fix: show error message when hook fails

`v4.0.1`

Compare Source

Fix: make Yarn silent. When Husky was installed with Yarn 1.21.1, hooks output was too verbose (#626).

`v4.0.0`

Compare Source

Support Yarn v2 new Plug'n'Play feature (thanks to @arcanis)
Improve path handling on Windows (in particular with Cygwin and Cmdr)
Remove dependencies and simplify code
Breaking requires Node 10+

Thanks to all contributors and everyone who is supporting Husky on Open Collective, GitHub sponsors and Patreon!

`v3.1.0`

Compare Source

Add pre-merge-commit hook (#605)

`v3.0.9`

Compare Source

Reduce dependencies: replace is-ci with ci-info #579

`v3.0.8`

Compare Source

Fix: git worktree support #580
Debug: check GIT_DIR environment variable when hooks are run

Fix: add shebang to run.js (#528)

`v3.0.1`

Compare Source

Improve error message if git command fails

`v3.0.0`

Compare Source

Fix HUSKY_SKIP_INSTALL=1 not skipping install
Breaking change husky requires now Git >= 2.13.2. If you're already using husky v2 and don't use an old version of Git, you can safely upgrade.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot force-pushed the renovate/husky-9.x branch 4 times, most recently from a3e3ea2 to 9aca963 Compare

January 29, 2024 16:23

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 9aca963 to 5b792d9 Compare

February 2, 2024 11:57

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 5b792d9 to ee5483a Compare

February 14, 2024 01:19

@renovate renovate bot force-pushed the renovate/husky-9.x branch 2 times, most recently from c93f34b to 6422921 Compare

July 18, 2024 13:41

@renovate renovate bot force-pushed the renovate/husky-9.x branch 3 times, most recently from 8f15802 to 53997e0 Compare

July 29, 2024 15:23

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 53997e0 to 5c062b4 Compare

August 20, 2024 14:57

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 5c062b4 to 893596d Compare

September 12, 2024 00:37

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 893596d to 3e31a72 Compare

November 18, 2024 15:40

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 3e31a72 to 7b09bcf Compare

August 10, 2025 15:19

@renovate


 chore(deps): update dependency husky to v9

a8f9d92

@renovate renovate bot force-pushed the renovate/husky-9.x branch from 7b09bcf to a8f9d92 Compare

November 18, 2025 23:43

Comments

Conversation

@renovate renovate bot commented Jan 25, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's new

Fixes

Deprecations

Friendly reminder

Sponsoring

Introducing husky init

v8

v9

Adding a New Hook

v8

v9

Further Size Reduction

More to Come

Other Changes

How to Migrate

What's Changed

Feats

Fixes

Docs

Chore

Breaking change

Added

Migrating from husky 4

Note about the license

Migrating

Configuration

Uh oh!

Reviewers

Assignees

Labels

@renovate renovate bot commented Jan 25, 2024 •

edited

Loading

Introducing `husky init`