Release Notes

Released on 2025-12-27.

Performance

• Use git cat-file -e in check if a rev exists (#1277)

Bug fixes

• Fix priority not applied for remote hooks (#1281)
• Report config file parsing error in auto-update (#1274)
• Unset GIT_DIR for auto-update (#1269)

Contributors

• @j178
• @branchv

Install prek 0.2.25

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.25/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.25/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.25

Download prek 0.2.25

Release Notes

Released on 2025-12-23.

Enhancements

• Build and publish docker image to ghcr.io/j178/prek (#1253)
• Support git urls for rust dependencies (#1256)

Bug fixes

• Ensure running uv pip install inside the remote repo path (#1262)
• Fix check-added-large-files for traced files (#1260)
• Respect GIT_DIR set by git (#1258)

Documentation

• Add docker integration docs (#1254)
• Clarify priority scope across repos (#1251)
• Improve documentation for configurations (#1247)
• Render changelog in document site (#1248)

Contributors

• @j178
• @branchv

Install prek 0.2.24

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.24/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.24/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.24

Download prek 0.2.24

Release Notes

Released on 2025-12-20.

Highlights

🚀 This release introduces priority-based parallel hook execution: prek can run multiple hooks in parallel when they share the same priority, which can be a huge speed-up for many configs. See configuration docs for priority.

Enhancements

• Allow uv reading user-level or system-level configuration files (#1227)
• Implement check-case-conflict as builtin hook (#888)
• Implement priority based parallel execution (#1232)

Bug fixes

• Fix check-executable-have-shebangs "command line too long" error on Windows (#1236)

Documentation

• Add FastAPI to the list of projects using prek (#1241)
• Document hook_types flag and default_install_hook_types behavior (#1225)
• Improve documentation for priority (#1245)
• Mention prek can be installed viataiki-e/install-action@prek (#1234)

Contributors

• @j178
• @copilot-swe-agent
• @lmmx

Install prek 0.2.23

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.23/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.23/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.23

Download prek 0.2.23

Release Notes

Released on 2025-12-13.

Highlights

In this release, prek adds support for the --cooldown-days option in the prek auto-update command.
This option allows users to skip releases that are newer than a specified number of days.
It is useful to mitigate open source supply chain risks by avoiding very recent releases that may not have been widely adopted or vetted yet.
Big thanks to @lmmx for driving this feature!

Enhancements

• Support--cooldown-days in prek auto-update (#1172)
  • Prefer tag creation timestamp in --cooldown-days (#1221)
• Use cargo install for packages in workspace (#1207)

Bug fixes

• Set CARGO_HOME for cargo metadata (#1209)

Contributors

• @j178
• @lmmx

Install prek 0.2.22

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.22/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.22/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.22

Download prek 0.2.22

Release Notes

Released on 2025-12-09.

Bug fixes

• Fallback to use remote repo package root instead of erroring (#1203)
• Prepend toolchain bin directory to PATH when calling cargo (#1204)
• Use cargo from installed toolchain (#1202)

Contributors

• @j178

Install prek 0.2.21

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.21/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.21/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.21

Download prek 0.2.21

Release Notes

Released on 2025-12-08.

Highlights

In this release:

• Rust hooks are now fully supported with automatic toolchain management, including package discovery in virtual workspaces. Big thanks to @lmmx for driving this.
• Added a prek cache size subcommand so you can quickly see how much cache space prek is using. Thanks @MatthewMckee4!
• Nested workspaces are easier to reason about: set orphan: true on a project to isolate it from parents so its files are processed only once.

Want to show your project runs on prek? Add our README badge to your docs or repo homepage:

Enhancements

• Support Rust language (#989)
  • Refactor Rust toolchain management (#1198)
  • Add support for finding packages in virtual workspaces (#1180)
• Add prek cache size command (#1183)
• Support orphan projects (#1129)
• Fallback to manual stage for hooks specified directly in command line (#1185)
• Make go module cache read-writeable (thus deletable) (#1164)
• Provide more information when validating configs and manifests (#1182)
• Improve error message for invalid number of arguments to hook-impl (#1196)

Bug fixes

• Disable git terminal prompts (#1193)
• Prevent post-checkout deadlock when cloning repos (#1192)
• Prevent color output when redirecting stdout to a file (#1159)

Documentation

• Add MacPorts to installation methods (#1157)
• Add a FAQ page explaining prek install --install--hooks (#1162)

Other changes

• Add prek: enabled repo badge (#1171)
• Add favicon for docs website (#1187)

Contributors

• @MatthewMckee4
• @lmmx
• @j178
• @joshmarkovic
• @frazar
• @jmelahman
• @drainpixie

Install prek 0.2.20

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.20/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.20/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.20

Download prek 0.2.20

Release Notes

Released on 2025-11-26.

Performance

• Simplify fix_byte_order_marker hook (#1136)
• Simplify trailing-whitespace hook to improve performance (#1135)

Bug fixes

• Close stdin for hook subcommands (#1155)
• Fix parsing Python interpreter info containing non-UTF8 chars (#1141)

Contributors

• @chilin0525
• @nblock
• @j178

Install prek 0.2.19

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.19/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.19/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.19

Download prek 0.2.19

Release Notes

Released on 2025-11-21.

Highlights

In this release, prek adds a new special repo type repo: builtin that lets you use built‑in hooks.
It basically gives you another way to use the existing built‑in fast path for pre‑commit‑hooks, but without needing to point to an external repo.
Since prek doesn’t have to clone anything or set up a virtual environment, repo: builtin hooks work even in air‑gapped environments.

For more details, see: https://prek.j178.dev/builtin/

Enhancements

• Add support repo: builtin (#1118)
• Enable virtual terminal processing on Windows (#1123)

Bug fixes

• Do not recurse into submodules during workspace discovery (#1121)
• Do not dim the hook output (#1126)
• Further reduce max cli length for cmd.exe on Windows (#1131)
• Revert "Disallow hook-level minimum_prek_version (#1101)" (#1120)

Other changes

• docs: refer airflow as Apache Airflow (#1116)

Contributors

• @j178
• @Lee-W

Install prek 0.2.18

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.18/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.18/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.18

Download prek 0.2.18

Release Notes

Released on 2025-11-18.

Bug fixes

• Revert back to use serde_yaml again (#1112)

Contributors

• @j178

Install prek 0.2.17

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.17/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.17/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.17

Download prek 0.2.17

Release Notes

Released on 2025-11-18.

Bug fixes

• Disallow hook-level minimum_prek_version (#1101)
• Do not require a project in prek init-template-dir (#1109)
• Make sure uv pip install uses the Python from virtualenv (#1108)
• Restore using serde_yaml in check-yaml hook (#1106)

Contributors

• @j178

Install prek 0.2.16

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.16/prek-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.16/prek-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install j178/tap/prek

Install prebuilt binaries into your npm project

npm install @j178/prek@0.2.16

Download prek 0.2.16