- #!/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 inv10.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 fornpx 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-commitprettier$(git diff --cached --name-only --diff-filter=ACMR| sed's| |\\ |g') --write --ignore-unknowngit update-index --again

For more advanced use cases, seelint-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 addexport 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: updatepackage-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 usinghusky@latest to get the bug fixes that were released after.

Introducing`husky init`

v8

npm pkgset scripts.prepare="husky install"npm run preparenpx 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 basicecho 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 approximately6kB.

v9 takes this a step further, reducing the size to just3kB, 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 forv9. 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.
Removedhusky install. Usehusky orhusky 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.
ReplacedHUSKY_DEBUG=1 withHUSKY=2 for debugging.
Updated the Husky API for module usage.
Transitioned toESM for module usage.
Dropped support for Node 14 and 16.
Revamped docs.

How to Migrate

v9 is backward compatible withv8, 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 usinghusky 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: addhusky - prefix to logged global error messages by@joshbalfour in#1092
feat: showPATH 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 ofsh by@skhaz in#1051
fix: actually set 'husky_skip_init' as readonly in./husky.sh by@hyperupcall in#1104
fix: forcebasename/dirname to treat$0 as an argument by@mataha in#1132
fix: removegit.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 deprecatednpx --no-install option withnpx --no by@sibiraj-s in#1070
docs: addpnpm installation by@MohamadKh75 in#1139