chore(deps): update dependency husky to v9 #541

- #!/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 https://github.com/typicode/husky/pull/1383
fix: export HUSKY=0 in init (fixes #1393) by @typicode in https://github.com/typicode/husky/pull/1395

`v9.0.10`

Compare Source

fix: rename index.d.ts to index.d.mts by @mrkjdy in https://github.com/typicode/husky/pull/1379

`v9.0.9`

Compare Source

refactor: rename files by @typicode in https://github.com/typicode/husky/pull/1378

`v9.0.8`

Compare Source

docs: update index.md by @khaledYS in https://github.com/typicode/husky/pull/1369
Fix tab detection on install command by @glensc in https://github.com/typicode/husky/pull/1376
refactor: reduce file size by @typicode in https://github.com/typicode/husky/pull/1377

`v9.0.7`

Compare Source

fix: typo and source ~/.huskyrc correctly (compatibility with v8)
docs: fix example by @typicode in https://github.com/typicode/husky/pull/1363

`v9.0.6`

Compare Source

docs: add favicon by @rakleed in https://github.com/typicode/husky/pull/1354
chore: apply editorconfig to code only by @typicode in https://github.com/typicode/husky/pull/1355
docs: update install script to mjs and fix CI checks by @starnayuta in https://github.com/typicode/husky/pull/1357
Fix unbound variable by @typicode in https://github.com/typicode/husky/pull/1359

`v9.0.5`

Compare Source

docs: update path to startup files by @ManuelRauber in https://github.com/typicode/husky/pull/1350
fix: init error by @typicode in https://github.com/typicode/husky/pull/1353

`v9.0.4`

Compare Source

fix: init create dir before by @typicode in https://github.com/typicode/husky/pull/1348
refactor: simplify by @typicode in https://github.com/typicode/husky/pull/1349
fix: init not working on pnpm #1334 by @rozbo in https://github.com/typicode/husky/pull/1347

`v9.0.3`

Compare Source

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

`v9.0.2`

Compare Source

fix: exit code by @gergelypap in https://github.com/typicode/husky/pull/1336
docs: typo by @chalkygames123 in https://github.com/typicode/husky/pull/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())

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 · 2024-12-08T18:35:04Z

Autoclosing Skipped

This PR has been flagged for autoclosing. However, it is being skipped due to the branch being already modified. Please close/delete it manually or report a bug if you think this is in error.

renovate · 2025-07-13T08:51:43Z

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.

renovate bot changed the title ~~chore(deps): update dependency husky to v9~~ chore(deps): update dependency husky to v9 - autoclosed Jan 25, 2024

renovate bot closed this Jan 25, 2024

renovate bot deleted the renovate/husky-9.x branch January 25, 2024 13:33

renovate bot changed the title ~~chore(deps): update dependency husky to v9 - autoclosed~~ chore(deps): update dependency husky to v9 Jan 25, 2024

renovate bot reopened this Jan 25, 2024

renovate bot restored the renovate/husky-9.x branch January 25, 2024 18:18

renovate bot force-pushed the renovate/husky-9.x branch from 49d0911 to cb50f93 Compare January 25, 2024 18:19

mfranzke enabled auto-merge (squash) January 25, 2024 19:25

renovate bot changed the title ~~chore(deps): update dependency husky to v9~~ chore(deps): update dependency husky to v9 - abandoned Dec 8, 2024

chore(deps): update dependency husky to v9

6d14570

renovate bot force-pushed the renovate/husky-9.x branch from d018c0c to 6d14570 Compare July 13, 2025 08:47

renovate bot changed the title ~~chore(deps): update dependency husky to v9 - abandoned~~ chore(deps): update dependency husky to v9 Jul 13, 2025

mfranzke added 6 commits July 13, 2025 10:48

Update commit-msg

7696b7e

Update pre-commit

35af8b3

Create .gitignore

a747a66

Delete .husky/.husky directory

a1c0864

Create .gitignore

60fdecd

Update package.json

4b48a67

mfranzke added 2 commits July 13, 2025 10:53

Update pre-commit

031183f

Merge branch 'main' into renovate/husky-9.x

63b9bc0

mfranzke approved these changes Jul 13, 2025

View reviewed changes

mfranzke merged commit 3f6561c into main Jul 13, 2025
10 checks passed

mfranzke deleted the renovate/husky-9.x branch July 13, 2025 08:58

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

chore(deps): update dependency husky to v9 #541

chore(deps): update dependency husky to v9 #541

Uh oh!

renovate bot commented Jan 25, 2024 •

edited

Loading

Uh oh!

renovate bot commented Dec 8, 2024

Uh oh!

renovate bot commented Jul 13, 2025

Uh oh!

Uh oh!

Uh oh!

chore(deps): update dependency husky to v9 #541

chore(deps): update dependency husky to v9 #541

Uh oh!

Conversation

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

Configuration

Uh oh!

renovate bot commented Dec 8, 2024

Autoclosing Skipped

Uh oh!

renovate bot commented Jul 13, 2025

Edited/Blocked Notification

Uh oh!

Uh oh!

Uh oh!

renovate bot commented Jan 25, 2024 •

edited

Loading

Introducing `husky init`