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

Release Notes

Released on 2025-11-17.

Highlights

prek is now available on crates.io! You can build prek from source via cargo install prek, for more details see Installation.

Enhancements

• Clean up hook environments when install fails (#1085)
• Prepare for publishing prek to crates.io (#1088)
• Replace serde-yaml with serde_saphyr (#1087)
• Warn unexpected keys in repo and hook level (#1096)

Bug fixes

• Fix prek init-template-dir fails in non-git repo (#1093)

Contributors

• @j178

Install prek 0.2.15

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.15/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.15

Download prek 0.2.15

Release Notes

Released on 2025-11-14.

Enhancements

• Support PREK_CONTAINER_RUNTIME=podman to override container runtime (#1033)
• Support rootless container runtime (#1018)
• Support language: unsupported and language: unsupported_script introduced in pre-commit v4.4 (#1073)
• Tweak to regex used for mountinfo (#1037)

Bug fixes

• Fix --files argument - files referencing other projects aren’t being filtered (#1064)
• Unset objectFormat in git init (#1048)

Documentation

• Add scoop to installation (#1067)
• Document workspace file visibility constraints (#1071)
• Add iceberg-python, msgspec and humanize to "who is using prek" (#1039, #1042, #1063)

Other changes

• Add a hint to install when running inside a sub-project (#1045)
• Add a hint to use --refresh when no configuration found (#1046)
• Run uv pip install from the current directory (#1069)

Contributors

• @zzstoatzz
• @st1971
• @yihong0618
• @j178
• @copilot-swe-agent
• @idlsoft

Install prek 0.2.14

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.14/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.14

Download prek 0.2.14

Release Notes

Released on 2025-11-04.

Enhancements

• Add Ruby support (no download support yet) (#993)
• Implement check-executables-have-shebangs as builtin-hook (#924)
• Improve container id detection (#1031)

Performance

• Optimize hot paths: reduce allocations (#997)
• Refactor identify using smallvec (#982)

Bug fixes

• Fix YAML with nested merge keys (#1020)
• Treat every file as executable on Windows to keep compatibility with pre-commit (#980)

Documentation

• Document that .gitignore is respected by default during workspace discovery (#983)
• Update project stability status (#1005)
• Add FastMCP to "who is using prek" (#1034)
• Add attrs to "who is using prek" (#981)

Contributors

• @my1e5
• @j178
• @zzstoatzz
• @lmmx
• @feliblo
• @yihong0618
• @st1971
• @is-alnilam

Install prek 0.2.13

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/j178/prek/releases/download/v0.2.13/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.13

Download prek 0.2.13