Release Notes

Released on 2026-10-21.

Enhancements

• Support system Rust toolchains without rustup (#2887)

Performance

• Use blocking file checks for CPU-heavy builtin hooks (#2910)

Other changes

• Update CA root crates and uv for the eMudhra intermediate CA compromise (#2919)

Contributors

• @shaanmajid
• @j178

Install prek 0.5.7

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.7

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-10-19.

Enhancements

• Add builtin hook check-commit-trailers (#2885)
• Add builtin hook check-signed-commit (#2725)

Performance

• Enable PGO for native release builds (#2890)
• Reduce hook process launches with balanced batches (#2907)
• Resolve hook commands before batching (#2840)

Bug fixes

• Accept UTF-8 BOM in check-json (#2879)
• Preserve unquoted dotted revisions in prek update (#2853)

Documentation

• Document standalone installer options (#2859)
• Update benchmarks for prek 0.5.5 (#2786)

Other changes

• Enable ICF for release builds (#2891)
• Update uv to 0.13.0 (#2856)

Contributors

• @ebuildy
• @j178
• @shaanmajid

Install prek 0.5.6

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.6

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-10-05.

Enhancements

• Add Nushell completion generation (#2785)
• Add ppc64le wheel and binary builds (#2809)

Performance

• Avoid JSON imports when querying Python interpreters (#2790)
• Avoid duplicate diffs after hooks rewrite files (#2815)
• Batch file reads in shebang checks (#2793)
• Check cached hook environments concurrently (#2797)
• Overlap Git discovery with worktree status checks (#2821)
• Query staged additions only for case conflicts (#2802)
• Reduce worker overhead in XML and pygrep checks (#2789)
• Reuse Git worktree state during hook startup (#2787)
• Reuse intent-to-add paths when saving unstaged changes (#2788)
• Run Git queries concurrently for case-conflict checks (#2792)
• Share Bun and Deno version queries across environments (#2795)
• Share Lua runtime probes across hook environments (#2796)
• Share Ruby version queries across hook environments (#2794)
• Share mise version queries across hook environments (#2798)
• Skip site initialization in Python interpreter probes (#2822)
• Skip untracked files in destroyed symlink checks (#2799)
• Skip unused file input for always-run hooks (#2813)

Bug fixes

• Preserve staged and unstaged changes on conflicted stash restore (#2803)
• Default missing core.fileMode in shebang checks (#2832)
• Match protected branch patterns from the start (#2829)
• Normalize explicit paths in shebang index checks (#2831)
• Preserve empty trailing-whitespace character sets (#2830)
• Reject empty files in check-json (#2826)
• Reject trailing data in check-json (#2828)
• Round up file sizes in check-added-large-files (#2827)

Documentation

• Redesign the prek badge and refresh logo details (#2818)

Contributors

• @imphil
• @j178

Install prek 0.5.5

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.5

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-09-28.

Highlights

Faster builtin hooks

In our end-to-end benchmark, prek is about 38% faster than 0.5.3, with some builtin
hooks up to 273% faster (check-yaml: 273%, check-json: 80%,
check-merge-conflict: 71%).

Enhancements

• Add include_deleted to allow hooks to include deleted files (#2733)
• Add --check and simplify end-of-file-fixer (#2764)
• Add --check to file-contents-sorter (#2765)
• Add --check to requirements-txt-fixer (#2766)
• Add --check to trailing-whitespace (#2763)
• Expose and document prek util generate-shell-completion (#2727)
• Support hide_status in project and user configuration (#2760)
• Support look-around regex in builtin pattern hooks (#2732)

Performance

• Cache the resolved Git executable on macOS (#2726)
• Combine and cache Git repository path queries (#2724)
• Optimize common builtin hook execution (#2768)
• Optimize scanning in mixed-line-ending and trailing-whitespace (#2769)
• Scan check-merge-conflict files in fixed-size blocks (#2781)
• Use SIMD UTF-8 validation in check-json, check-toml, and check-yaml (#2770)

Bug fixes

• Retry transient rename failures on Windows (#2756)
• Use PATH to resolve prek in completion scripts (#2719)

Documentation

• Clarify the flow and scope of usage guides (#2710)
• Reorganize usage guides and reference documentation (#2709)

Other changes

• Sync latest identify tags (#2762)

Contributors

• @github-actions
• @j178

Install prek 0.5.4

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.4

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-09-13.

Enhancements

• Add PEP 740 attestations for PyPI releases (#2705)
• Add a check-jsonc builtin hook (#2682)
• Allow disabling automatic uv installation (#2702)

Bug fixes

• Fix Julia additional dependency specifiers (#2703)
• Update granit-parser to fix YAML flow indentation (#2707)

Contributors

• @clbarnes
• @j178
• @tisonkun

Install prek 0.5.3

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.3

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-09-03.

Enhancements

• Allow unknown tags by default in check-yaml (#2678)

Contributors

• @j178

Install prek 0.5.2

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.2

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-09-01.

Enhancements

• Add --hide-status <passed|failed|skipped> for hook reports (#2644)
• Add prek init for repository setup (#2636)
• Apply hook env during environment creation (#2650)
• Disable error snippets in check-yaml diagnostics (#2664)
• Show hooks excluded by skip selectors (#2645)
• Support Pixi for Conda environments (#2667)
• Support cargo-binstall for Rust CLI dependencies (#2658)
• Warn about unused keys in user settings (#2665)

Bug fixes

• Reject unsupported YAML tags in check-yaml (#2656)

Documentation

• Clarify local hook documentation (#2640)
• Clarify pre-commit command compatibility (#2635)
• Document automatic PR fixes with autofix.ci (#2643)
• Document check-yaml unsafe support (#2632)
• Improve setup and workflow documentation (#2637)

Other changes

• Drop low-usage release targets (#2651)
• Generate a prek manifest JSON schema (#2648)

Contributors

• @j178

Install prek 0.5.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.1

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-08-27.

Highlights

Choose where hook toolchains come from

language_version now accepts a source preference alongside the version
request, letting you control where prek looks for a compatible toolchain when
it creates a hook environment. Use managed (the default) or system to choose
which source prek tries first while still allowing fallback and downloads. Use
only-managed or only-system to require one source.

For example, this local Ruff hook requires a Python 3.12 toolchain managed by
prek:

repos:
  - repo: local
    hooks:
      - id: ruff
        name: ruff
        language: python
        entry: ruff check
        additional_dependencies: [ruff]
        language_version:
          request: "3.12"
          preference: only-managed

With only-managed, prek reuses a compatible toolchain from its managed store
or downloads one when needed. It never falls back to Python from PATH, an OS
package manager, or a version manager, so toolchain selection does not depend on
the developer or CI machine's external environment.

Existing scalar values such as language_version: "3.12" continue to work. See
toolchain management and language_version
for the full source-selection behavior. (#2613)

Breaking changes

The breaking changes in this release are mostly small cleanups, and most users should not be affected.

• Group names can no longer start with @. This prefix is now reserved for special group selectors such as the new @ungrouped selector. (#2617)
• PREK_MAX_CONCURRENCY has been removed. Use PREK_CONCURRENT_HOOKS and PREK_CONCURRENT_BATCHES to control hook and per-hook batch concurrency separately. (#2620)
• The top-level prek init-template-dir command has been removed. Use prek util init-template-dir, or prek init-templatedir for drop-in compatibility with pre-commit. (#2623)
• prek auto-update has been removed. Use prek update, or prek autoupdate for drop-in compatibility with pre-commit. (#2619)

Enhancements

• Add configurable toolchain source preferences (#2613)
• Allow explicit language: python to opt out of fast-path hooks (#2608)
• Group run and update options in CLI help (#2629)
• Preserve terminal theme contrast for status labels (#2592)
• Add @ungrouped group selector (#2617)
• Retry uv installation with static musl binary (#2600)
• Support {hook_repo} placeholder in hook entry (#2602)

Bug fixes

• Expose the git work tree to hooks running outside the git root (#2579)
• Isolate local hook environment installation (#2615)
• Preserve hook config deserialization error locations (#2573)
• Resolve hook log files from their config directory (#2580)
• Track explicit config paths as absolute paths (#2574)

Documentation

• Document prek run architecture (#2630)
• Publish versioned documentation (#2626)

Contributors

• @jeromeheissler
• @gurgeous
• @j178

Install prek 0.5.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.5.0

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-08-17.

Enhancements

• Support check-yaml unsafe mode (#2546)

Performance

• Reuse allocations in common filters (#2548)

Bug fixes

• Accept non-finite floats in check-yaml (#2545)
• Allow comment-heavy YAML in check-yaml (#2554)
• Sanitize captured terminal output before replay (#2552)

Contributors

• @j178

Install prek 0.4.14

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.4.14

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

Release Notes

Released on 2026-08-10.

Highlights

Manage hook tools with mise

The new language: mise support lets hooks install tools using
mise in an isolated environment:

repos:
  - repo: local
    hooks:
      - id: golangci-lint
        name: golangci-lint
        language: mise
        additional_dependencies: ["aqua:golangci/golangci-lint@2"]
        entry: golangci-lint run --fast-only ./...
        pass_filenames: false

Run commands in hook environments

The new prek exec subcommand can run an explicit command in a configured
hook's prepared environment. For example, the hook above makes its managed
binary available to this command:

$ prek exec golangci-lint -- golangci-lint --version

Enhancements

• Add mise language support (#2540)
• Add deny-filename-pattern and require-filename-pattern hooks (#2488)
• Add prek exec for running commands in a hook environment (#2478)
• Add yaml-language-server: comment to YAML sample config (#2486)
• Make prek cache size output terminal-aware (#2508)
• Match file regexes against path bytes (#2541)
• Show hook aliases in run output (#2497)
• Show hook descriptions in run output (#2490)

Performance

• Avoid env cache scans for skipped hooks (#2502)
• Cache Node version queries (#2500)

Bug fixes

• Fix Node hook installation with npm 11 (#2487)
• Isolate dependency installs from inherited Git repository state (#2506)

Documentation

• Document combined group filtering (#2495)
• Explain what prek does in README (#2507)
• Refresh "Why prek" highlights (#2474)

Contributors

• @will-wright-eng
• @Repiteo
• @j178

Install prek 0.4.13

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

brew install prek

Download prek 0.4.13

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo j178/prek

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>