Changelog

0.3.8

Released on 2026-03-23.

Enhancements

Add experimental language: deno support (#1516)
Add pretty-format-json as builtin hook (#915)
Add check-vcs-permalinks as builtin hook (#1842)
Add check-illegal-windows-names as builtin hook (#1841)
Add check-shebang-scripts-are-executable builtin hook (#1847)
Add destroyed-symlinks builtin hook (#1851)
Add file-contents-sorter as builtin hook (#1846)
Add --all flag to prek uninstall (#1817)
Improve file pattern parse errors (#1829)
Validate uv binary after download (#1825)

Bug fixes

Fix workspace-relative added file paths (#1852)
Relax alias-anchor ratio check for check-yaml (#1839)

Contributors

@j178
@shaanmajid
@mvanhorn
@feliblo
@Tiryoh

0.3.7

Due to a release process failure, this version was republished as 0.3.8.

0.3.6

Released on 2026-03-16.

Enhancements

Allow selectors for hook ids containing colons (#1782)
Rename prek install-hooks to prek prepare-hooks and prek install --install-hooks to prek install --prepare-hooks (#1766)
Retry auth-failed repo clones with terminal prompts enabled (#1761)

Performance

Optimize detect_private_key by chunked reading and using aho-corasick (#1791)
Optimize fix_byte_order_marker by shifting file contents in place (#1790)

Bug fixes

Align stage defaulting behavior with pre-commit (#1788)
Make sure child output is drained in the PTY subprocess (#1768)
fix(golang): use GOTOOLCHAIN=local when probing system go (#1797)

Documentation

Disambiguate “hook” terminology by renaming "Git hooks" to "Git shims" (#1776)
Document compatibility with pre-commit (#1767)
Update configuration.md with TOML 1.1 notes (#1764)

Other changes

Sync latest identify tags (#1798)

Contributors

@github-actions
@j178
@pcastellazzi
@deadnews
@copilot-swe-agent

0.3.5

Released on 2026-03-09.

Enhancements

Add automatic Ruby download support using rv binaries (#1668)
Adjust open file limit on process startup (#1705)
Allow parallel gem retry (#1732)
Enable system-proxy feature on reqwest (#1738)
Expose --git-dir to force hook installation target (#1723)
Pass --quiet, --verbose, and --no-progress through prek install into generated hook scripts (#1753)
Respect core.sharedRepository for hook permissions (#1755)
Support legacy mode hook script (#1706)
rust: support cli: git dependency 4th segment package disambiguation (#1747)

Bug fixes

Fix Python __main__.py entry (#1741)
python: strip UV_SYSTEM_PYTHON from uv venv and pip install commands (#1756)

Other changes

Sync latest identify tags (#1733)

Contributors

@Dev-iL
@tennox
@shaanmajid
@is-alnilam
@github-actions
@j178

0.3.4

Released on 2026-02-28.

Enhancements

Allow pass_filenames to accept a positive integer (#1698)
Install and compile gems in parallel (#1674)
Sync identify file-type mappings with pre-commit identify (#1660)
Use --locked for Rust cargo install commands (#1661)
Add PREK_MAX_CONCURRENCY environment variable for configuring maximum concurrency (#1697)
Add PREK_LOG_TRUNCATE_LIMIT environment variable for configuring log truncation (#1679)
Add support for python -m prek (#1686)

Bug fixes

Skip invalid Rust toolchains instead of failing (#1699)

Performance

Bitset-based TagSet refactor: precompute tag masks and speed up hook type filtering (#1665)

Documentation

Document winget install j178.Prek (#1670)

Contributors

@uplsh580
@Svecco
@dbast
@drichardson
@JP-Ellis
@j178
@is-alnilam
@copilot-swe-agent

0.3.3

Released on 2026-02-15.

Enhancements

Read Python version specifier from hook repo pyproject.toml (#1596)
Add #:schema directives to generated prek.toml (#1597)
Add prek util list-builtins command (#1600)
Expand install source detection to mise, uv tool, pipx, and asdf (#1605, #1607)
Add progress bar to cache clean and show removal summary (#1616)
Make yaml-to-toml CONFIG argument optional (#1593)
prek uninstall removes legacy scripts too (#1622)

Bug fixes

Fix underflow when formatting summary output (#1626)
Match files/exclude filter against relative path of nested project (#1624)
Select musllinux wheel tag for uv on musl-based distros (#1628)

Documentation

Clarify prek list description (#1604)

Contributors

@ichoosetoaccept
@shaanmajid
@soraxas
@9999years
@j178

0.3.2

Released on 2026-02-06.

Highlights

prek.toml is here!

You can now use prek.toml as an alternative to .pre-commit-config.yaml for configuring prek. prek.toml mirrors the structure of .pre-commit-config.yaml, but TOML is less error-prone. Your existing .pre-commit-config.yaml will continue to work, but for new users and new projects, prek.toml may make more sense. If you want to switch, run prek util yaml-to-toml to convert YAML configs to prek.toml. See configuration docs for details.

For example, this config:
```
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v6.0.0
    hooks:
      - id: check-yaml
```
Can be written as prek.toml like this:
```
[[repos]]
repo = "https://github.com/pre-commit/pre-commit-hooks"
rev = "v6.0.0"
hooks = [ { id = "check-yaml" } ]
```

serde-yaml has been replaced with serde-saphyr

We replaced the long-deprecated serde-yaml crate with serde-saphyr for YAML parsing. It is written in safe Rust and has better error messages, performance, and security. This lets us provide precise location information for configuration parsing errors, which should make it easier to fix config issues.

For example, this invalid config:

repos:
  - repo: https://github.com/crate-ci/typos
    hooks:
      - id: typos

Before:

$ prek run
error: Failed to parse `.pre-commit-config.yaml`
  caused by: Invalid remote repo: missing field `rev`

Now:

$ prek run
error: Failed to parse `.pre-commit-config.yaml`
caused by: error: line 2 column 5: missing field `rev` at line 2, column 5
--> <input>:2:5
  |
1 | repos:
2 |   - repo: https://github.com/crate-ci/typos
  |     ^ missing field `rev` at line 2, column 5
3 |     hooks:
4 |       - id: typos
  |

prek util subcommands

We added a new prek util top-level command for miscellaneous utilities that don't fit into other categories. The first two utilities are:
- prek util identify: shows the identification tags of files that prek uses for file filtering, which can be useful for debugging and writing types/types_or/exclude_types filters.
- prek util yaml-to-toml: converts .pre-commit-config.yaml to prek.toml.
We also moved prek init-template-dir under prek util for better organization. The old prek init-template-dir command is still available (hidden) as an alias for backward compatibility.

Enhancements

Add prek util identify subcommand (#1554)
Add prek util yaml-to-toml to convert .pre-commit-config.yaml to prek.toml (#1584)
Detect install source for actionable upgrade hints (#1540)
Detect prek installed by the standalone installer (#1545)
Implement serialize_yaml_scalar using serde-saphyr (#1534)
Improve max cli arguments length calculation (#1518)
Move identify and init-template-dir under the prek util top-level command (#1574)
Replace serde-yaml with serde-saphyr (again) (#1520)
Show precise location for config parsing error (#1530)
Support Julia language (#1519)
Support prek.toml (#1271)
Added PREK_QUIET environment variable support (#1513)
Remove upper bound constraint of uv version (#1588)

Bug fixes

Do not make the child a session leader (#1586)
Fix FilePattern schema to accept plain strings (#1564)
Use semver fallback sort when tag timestamps are equal (#1579)

Documentation

Add OpenClaw to the list of users (#1517)
Add cachix/devenv, apache/lucene, copper-project/copper-rs as projects using prek (#1531, #1514, #1569)
Add document about authoring remote hooks (#1571)
Add llms.txt generation for LLM-friendly documentation (#1553)
Document using --refresh to pick up .prekignore changes (#1575)
Fix PowerShell completion instruction syntax (#1568)
Update quick start to use prek.toml (#1576)

Other changes

Include prek.toml in run hint for config filename (#1578)

Contributors

@fatelei
@domenkozar
@makeecat
@fllesser
@j178
@copilot-swe-agent
@oopscompiled
@rmuir
@shaanmajid

0.3.1

Released on 2026-01-31.

Enhancements

Add language: swift support (#1463)
Add language: haskell support (#1484)
Extract go version constraint from go.mod (#1457)
Warn when config file exists but fails to parse (#1487)
Add GitHub artifact attestations to release and build-docker workflow (#1494, #1497)
Allow GIT_CONFIG_PARAMETERS for private repository authentication (#1472)
Show progress bar when running builtin hooks (#1504)

Bug fixes

Cap ARG_MAX at 1<<19 for safety (#1506)
Don't check Python executable path in health check (#1496)

Documentation

Include CocoIndex as a project using prek (#1477)
Add commands for artifact verification using GitHub Attestations (#1500)

Contributors

@halms
@Haleshot
@simono
@tisonkun
@fllesser
@j178
@shaanmajid

0.3.0

Released on 2026-01-22.

Highlights

prek cache gc (also available via prek gc for pre-commit compatibility) is finally here! You can now run prek cache gc to clean up unused repos, hook envs and tool versions from prek cache.
language: bun is now supported, making it possible to write and run hooks with Bun.

Enhancements

Implement prek cache gc (#1410)
- Bootstrap tracking configs from workspace cache (#1417)
- Show total size prek cache gc removed (#1418)
- Show accurate repo and hook details in prek cache gc -v (#1420)
- prek cache gc remove specific unused tool versions (#1422)
- Fix unused tool versions not removed in prek cache gc (#1436)
Add language: bun support (#1411)
- Use git ls-remote --tags to list bun versions (#1439)
Accept --stage as an alias for --hook-stage in prek run (#1398)
Expand ~ tilde in PREK_HOME (#1431)
Support refs to trees (#1449)

Bug fixes

Avoid file lock warning for in-process contention (#1406)
Resolve relative repo paths from config file directory (#1443)
fix: use split() instead of resolve(None) for builtin hook argument parsing (#1415)

Documentation

Add simple-icons and ast-grep to the users of prek (#1403)
Improve JSON schema for repo field (#1432)
Improve JSON schema for builtin and meta hooks (#1427)
Add pronunciation entry to FAQ (#1442)
Add commitizen to the list of projects using prek (#1413)
Move docs to zensical (#1421)

Other Changes

Refactor config layout (#1407)

Contributors

@shaanmajid
@KevinGimbel
@jtamagnan
@jmeickle-theaiinstitute
@YazdanRa
@j178
@mschoettle
@tisonkun

0.2.30

Released on 2026-01-18.

Enhancements

Build binaries using minimal-size profile (#1376)
Check for duplicate keys in check-json5 builtin hook (#1387)
Preserve quoting style in auto-update (#1379)
Show warning if file lock acquiring blocks for long time (#1353)
Singleflight Python health checks with cached interpreter info (#1381)

Bug fixes

Do not resolve entry for docker_image (#1386)
Fix command lookup on Windows (#1383)

Documentation

Document language support details (#1380)
Document that check-json5 now rejects duplicate keys (#1391)

Contributors

@j178

0.2.29

Released on 2026-01-16.

Highlights

files / exclude now support globs (including glob lists), making config filters much easier to read and maintain than heavily-escaped regex.

Before (regex):

files: "^(src/.*\\.rs$|crates/[^/]+/src/.*\\.rs$)"

After (glob list):

files:
  glob:
    - src/**/*.rs
    - crates/**/src/**/*.rs

Enhancements

Add check-json5 as builtin hooks (#1367)
Add glob list support for file patterns (files and exclude) (#1197)

Bug fixes

Fix missing commit hash from version info (#1352)
Remove git env vars from uv pip install subprocess (#1355)
Set TERM=dumb under PTY to prevent capability-probe hangs (#1363)

Documentation

Add home-assistant/core to the users of prek (#1350)
Document builtin hooks (#1370)
Explain project configuration scope (#1373)

Contributors

@Goldziher
@yihong0618
@j178
@shaanmajid
@ulgens

0.2.28

Released on 2026-01-13.

Enhancements

Avoid running git diff for skipped hooks (#1335)
More accurate command line length limit calculation (#1348)
Raise platform command line length upper limit (#1347)
Use /bin/sh in generated git hook scripts (#1333)

Bug fixes

Avoid rewriting if config is up-to-date (#1346)

Documentation

Add ty to the users of prek (#1342)
Add ruff to the users of prek (#1334)
Complete configuration document (#1338)
Document UV environment variable inheritance in prek (#1339)

Contributors

@copilot-swe-agent
@MatthewMckee4
@yihong0618
@j178

0.2.27

Released on 2026-01-07.

Highlights

python/cpython is now using prek. That’s the highlight of this release!

Enhancements

Add hook-level env option to set environment variables for hooks (#1279) (#1285)
Support apple's container for docker language (#1306)
Skip cookiecutter template directories like {{cookiecutter.project_slug}} during project discovery (#1316)
Use global CONCURRENCY for repo clone (#1292)
untar: disallow external symlinks (#1314)

Bug fixes

Exit with success if no hooks match the hook stage (#1317)
Fix Go template string to detect rootless podman (#1302)
Panic on overly long filenames instead of silently dropping files (#1287)

Other changes

Add python/cpython to users (#1308)
Add MoonshotAI/kimi-cli to users (#1286)
Drop powerpc64 wheels (#1319)

Contributors

@ulgens
@loganaden
@danielparks
@branchv
@j178
@yihong0618
@mocknen
@copilot-swe-agent
@ZhuoZhuoCrayon

0.2.25

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

0.2.24

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

0.2.23

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

0.2.22

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

0.2.21

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

0.2.20

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

0.2.19

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

0.2.18

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

0.2.17

Released on 2025-11-18.

Bug fixes

Revert back to use serde_yaml again (#1112)

Contributors

@j178

0.2.16

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

0.2.15

Released on 2025-11-17.

Highlights

prek is now available on crates.io! You can build prek from source via cargo install prek or cargo binstall 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

0.2.14

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

0.2.13

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

0.2.12

Released on 2025-10-27.

Enhancements

Add a warning for unimplemented hooks (#976)
Allow using system trusted store by PREK_NATIVE_TLS (#959)

Bug fixes

Do not check for script subprocess status (#964)
Fix compatibility with older luarocks (#967)
Fix local relative path in try-repo (#975)

Documentation

Update language support status (#970)

Contributors

@yihong0618
@st1971
@j178

0.2.11

Released on 2025-10-24.

Enhancements

Support language: lua hooks (#954)
Support language_version: system (#949)
Implement no-commit-to-branch as builtin hook (#930)
Improve styling for stashing error message (#953)
Support nix-shell style shebang (#929)

Documentation

Add a page about "Quick start" (#934)
Add kreuzberg to "who is using prek" (#936)
Clarify minimum mise version required to use mise use prek (#931)

Contributors

@fllesser
@j178

0.2.10

Released on 2025-10-18.

Enhancements

Add --fail-fast CLI flag to stop after first hook failure (#908)
Add collision detection for hook env directories (#914)
Error out if not projects found (#913)
Implement check-xml as builtin hook (#894)
Implement check-merge-conflict as builtin hook (#885)
Use line-by-line reading in check-merge-conflict (#910)

Bug fixes

Fix pygrep hook env health check (#921)
Group pygrep with python when installing pygrep hooks (#920)
Ignore . prefixed directory when searching managed Python for pygrep (#919)

Documentation

Add contribution guide (#912)

Other changes

Contributors

@AdityasWorks
@j178
@kenwoodjw
@lmmx

0.2.9

Released on 2025-10-16.

Enhancements

Lazily check hook env health (#897)
Implement check-symlinks as builtin hook (#895)
Implement detect-private-key as builtin hook (#893)

Bug fixes

Download files to scratch directory to avoid cross-filesystem rename (#889)
Fix golang hook install local dependencies (#902)
Ignore the user-set UV_MANAGED_PYTHON (#900)

Other changes

Add package metadata for cargo-binstall (#882)

Contributors

@j178
@lmmx

0.2.8

Released on 2025-10-14.

This is a re-release of 0.2.6 that fixes an issue where publishing to npmjs.com failed.

Enhancements

Publish prek to npmjs.com (#819)
Support YAML merge keys in .pre-commit-config.yaml (#871)

Bug fixes

Use relative path with --cd in the generated hook script (#868)
Fix autoupdate rev rendering for "float-like" version numbers (#867)

Documentation

Add Nix and Conda installation details (#874)

Contributors

@mondeja
@j178
@bbannier
@yihong0618
@colindean

0.2.5

Released on 2025-10-10.

Enhancements

Implement prek try-repo (#797)
Add fallback mechanism for prek executable in git hooks (#850)
Ignore config error if the directory is skipped (#860)

Bug fixes

Fix panic when parse config failed (#859)

Other changes

Add a Dockerfile (#852)

Contributors

@j178
@luizvbo

0.2.4

Released on 2025-10-07.

Enhancements

Add support for .prekignore to ignore directories from project discovery (#826)
Make prek auto-update --jobs default to 0 (which uses max available parallelism) (#833)
Improve install message when installing for a subproject (#847)

Bug fixes

Convert extension to lowercase before checking file tags (#839)
Support pass multiple files like prek run --files a b c d (#828)

Documentation

Add requests-cache to "Who is using prek" (#824)

Contributors

@SigureMo
@j178

0.2.3

Released on 2025-09-29.

Enhancements

Add --dry-run to prek auto-update (#806)
Add a global --log-file flag to specify the log file path (#817)
Implement hook health check (#798)
Show error message in quiet mode (#807)

Bug fixes

Write fail entry into output directly (#811)

Documentation

Update docs about uv in prek (#810)

Other changes

Add a security policy for reporting vulnerabilities (#804)

Contributors

@mondeja
@j178

0.2.2

Released on 2025-09-26.

Enhancements

Add prek cache dir, move prek gc and prek clean under prek cache (#795)
Add a hint when hooks failed in CI (#800)
Add support for specifying PREK_UV_SOURCE (#766)
Run docker container with --init (#791)
Support --allow-multiple-documents for check-yaml (#790)

Bug fixes

Fix interpreter identification (#801)

Documentation

Add PaperQA2 to "Who is using prek" (#793)
Clarify built-in hooks activation conditions and behavior (#781)
Deduplicate docs between README and MkDocs site (#792)
Mention j178/prek-action in docs (#753)

Other Changes

Bump pre-commit-hooks in sample-config to v6.0.0 (#761)
Improve arg parsing for builtin hooks (#789)

Contributors

@mondeja
@akx
@bxb100
@j178
@onerandomusername

0.2.1

Enhancements

auto-update: prefer tags that are most similar to the current version (#719)

Bug fixes

Fix git --no-pager diff command syntax upon failures (#746)
Clean working tree of current workspace only (#747)
Use concurrent read and write in git check-attr (#731)

Documentation

Fix typo in language-version to language_version (#727)
Update benchmarks (#728)

Contributors

@j178
@matthiask
@AdrianDC
@onerandomusername

0.2.0

This is a huge milestone release that introduces Workspace Mode — first‑class monorepo support.

prek now allows you to manage multiple projects with their own .pre-commit-config.yaml within a single repository. It auto‑discovers nested projects, runs hooks in project scope, and provides flexible selectors to target specific projects and hooks. This makes prek a powerful tool for managing pre-commit hooks in complex repository structures.

For more details, see Workspace Mode. If you encounter any issues, please report them at Issues.

Note: If you ran prek install in a repo before, you gonna need to run prek install again to replace the old git hook scripts for the workspace mode to work.

Special thanks to @potiuk for all the help and feedback in designing and testing this feature!

For detailed changes between 0.1.6 and 0.2.0, see 0.2.0-alpha.2, 0.2.0-alpha.3, 0.2.0-alpha.4, and 0.2.0-alpha.5.

Enhancements

Fix parsing of tag describe for prerelease versions (#714)
Truncate log file each time (#717)

Performance

Enable more aggressive optimizations for release (#724)
Speed up check_toml (#713)

Bug fixes

Fix hook-impl don't run hooks when specified allow missing config (#716)
fix: support py38 for pygrep (#723)

Other changes

Fix installation on fish and with missing tags (#721)

Contributors

@onerandomusername
@kushudai
@j178

0.2.0a5

Enhancements

Add built in byte-order-marker fixer (#700)
Use bigger buffer for fixing trailing whitespace (#705)

Bug fixes

Fix trailing-whitespace & mixed-line-ending write file path (#708)
Fix file path handling for meta hooks in workspace mode (#699)

Documentation

Add docs about configuration (#703)
Add docs about debugging (#702)
Generate cli reference (#707)

Contributors

@kushudai
@j178

0.2.0a4

Enhancements

Bring back .pre-commit-config.yml support (#676)
Ignore config file from hidden directory (#677)
Support selectors in prek install/install-hooks/hook-impl (#683)

Bug fixes

Do not set GOROOT for system install Go when running go hooks (#694)
Fix check_toml and check_yaml in workspace mode (#688)

Documentation

Add docs about TODOs (#679)
Add docs about builtin hooks (#678)

Other changes

docs(manifest): Correctly specify metadata for all packages (#687)
refactor(cli): Clean up usage of clap (#689)

Contributors

@j178
@epage
@aravindan888

0.2.0a3

Enhancements

Add a warning to hook-impl when the script needs reinstall (#647)

Documentation

Add a notice to rerun prek install when upgrading to 0.2.0 (#646)

Contributors

@j178

0.2.0-alpha.2

This is a re-release of 0.2.0-alpha.1, fixed an issue that prereleases are not published to PyPI.

This is a huge milestone release that introduces Workspace Mode — first‑class monorepo support.

Note: If you ran prek install in a repo before, you gonna need to run prek install again to replace the old git hook scripts for the workspace mode to work.

For more details, see Workspace Mode. If you encounter any issues, please report them at Issues.

Special thanks to @potiuk for all the help and feedback in designing and testing this feature!

Enhancements

Support multiple .pre-commit-config.yaml in a workspace (monorepo mode) (#583)
Implement project and hook selector (#623)
Add prek run --cd <dir> to change directory before running (#581)
Support prek list in workspace mode (#586)
Support prek install|install-hooks|hook-impl|init-template-dir in workspace mode (#595)
Implement auto-update in workspace mode (#605)
Implement selector completion in workspace mode (#639)
Simplify auto-update implementation (#608)
Add a --dry-run flag to prek run (#622)
Cache workspace discovery result (#636)
Fix local script hook entry path in workspace mode (#603)
Fix hook-impl allow missing config (#600)
Fix docker mount in workspace mode (#638)
Show project line when project is not root (#637)

Documentation

Publish docs to https://prek.j178.dev (#627)
Improve workspace docs about skips rule (#615)
Add an full example and update docs (#582)

Other changes

Docs: .pre-commit-config.yml support has been removed (#630)
Enable publishing prereleases (#641)

Contributors

0.1.6

Enhancements

Improve hook install concurrency (#611)
Parse JSON from slice (#604)

Bug fixes

Reuse hook env only for exactly same dependencies (#609)
Workaround checkout file failure on Windows (#616)

0.1.5

Enhancements

Implement pre-push hook type (#598)
Implement pre-commit-hooks:check_yaml as builtin hook (#557)
Implement pre-commit-hooks:check-toml as builtin hook (#564)
Add validation for file type tags (#565)
Ignore NotFound error in extracting metadata log (#597)

Documentation

Update project status (#578)

Other changes

Bump tracing-subscriber to 0.3.20 (#567)
Remove color from trace log (#580)

0.1.4

Enhancements

Improve docker image labels (#551)

Performance

Avoid unnecessary allocation in run_by_batch (#549)
Cache current docker container mounts (#552)

Bug fixes

Fix trailing-whitespace cannot handle file contains invalid utf-8 data (#544)
Fix trailing-whitespace eol trimming (#546)
Fix trailing-whitespace markdown eol trimming (#547)

Documentation

Add authlib to Who are using prek (#550)

0.1.3

Enhancements

Support PEP 723 scripts for Python hooks (#529)

Bug fixes

Fix Python hook stderr are not captured (#530)

Other changes

Add an error context when reading manifest failed (#527)
Add a renovate rule to bump bundled uv version (#528)
Disable semantic commits for renovate PRs (#538)

0.1.2

Enhancements

Add check for missing hooks in new revision (#521)

Bug fixes

Fix language: script entry join issue (#525)

Other changes

Add OpenLineage to prek users (#523)

0.1.1

Breaking changes

Drop support .yml config file (#493)

Enhancements

Add moving rev warning (#488)
Implement prek auto-update (#511)
Support local path as a repo url (#513)

Bug fixes

Fix recursion limit when checking deeply nested json (#507)
Fix rename tempfile across device (#508)
Fix build on s390x (#518)

Other changes

docs: install prek with mise (#510)

0.0.29

Enhancements

Build wheels for more platforms (#489)

Bug fixes

Fix git commit -a does not pick up staged files correctly (#487)

0.0.28

Bug fixes

Fix inde.lock file exists error when running git commit -p or git commit -a (#482)
Various fixes to init-templdate-dir and directory related bug (#484)

0.0.27

Enhancements

Clone repo temporarily into scratch directory (#478)
Don’t show the progress bar if there’s no need for cloning or installing hooks (#477)
Support language_version: lts for node (#473)

Bug fixes

Adjust sample-config file path before writing (#474)
Resolve script shebang before running (#475)

0.0.26

Enhancements

Disable prek self update for package managers (#468)
Download uv from github releases directly (#464)
Find uv alongside the prek binary (#466)
Run hooks with pty if color enabled (#471)
Warn unexpected keys in config (#463)

Bug fixes

Canonicalize prek executable path (#467)

Documentation

Add "Who are using prek" to README (#458)

0.0.25

Enhancements

Add check for minimum_prek_version (#437)
Make --to-ref default to HEAD if --from-ref is specified (#426)
Support downloading uv from pypi and mirrors (#449)
Write trace log to $PREK_HOME/prek.log (#447)
Implement mixed_line_ending as builtin hook (#444)
Support --output-format=json in prek list (#446)
Add context message to install error (#455)
Add warning for non-existent hook id (#450)

Performance

Refactor fix_trailing_whitespace (#411)

Bug fixes

Calculate more accurate max cli length (#442)
Fix uv install on Windows (#453)
Static link liblzma (#445)

0.0.24

Enhancements

Add dynamic completion of hook ids (#380)
Implement prek list to list available hooks (#424)
Implement pygrep language support (#383)
Support prek run multiple hooks (#423)
Implement check_json as builtin hook (#416)

Performance

Avoid reading whole file into memory in fix_end_of_file and make it consistent with pre-commit-hooks (#399)

Bug fixes

Do not set GOROOT and GOPATH for system found go (#415)

Documentation

Use brew install j178/tap/prek for now (#420)
chore: logo rebranded, Update README.md (#408)

0.0.23

Breaking changes

In this release, we've renamed the project to prek from prefligit. It's shorter so easier to type, and it avoids typosquatting with preflight.

This means that the command-line name is now prek, and the PyPI package is now listed as prek. And the Homebrew will be updated to prek as well.

And previously, the cache directory was ~/.cache/prefligit, now it is ~/.cache/prek. You'd have to delete the old cache directory manually, or run prefligit clean to clean it up.

Then uninstall the old prefligit and install the new prek from scratch.

Enhancements

Relax uv version check range (#396)

Bug fixes

Fix script command path (#398)
Fix meta hook check_useless_excludes (#401)

Other changes

Rename to prek from prefligit (#402)

0.0.22

Enhancements

Add value hint to prefligit run flags (#373)
Check minimum supported version for uv found from system (#352)

Bug fixes

Fix check_added_large_files parameter name (#389)
Fix npm install on Windows (#374)
Fix docker mount options (#377)
Fix identify tags for Pipfile.lock (#391)
Fix identifying symlinks (#378)
Set GOROOT when installing golang hook (#381)

Other changes

Add devcontainer config (#379)
Bump rust toolchain to 1.89 (#386)

0.0.21

Enhancements

Add --directory to prefligit run (#358)
Implement tags_from_interpreter (#362)
Set GOBIN to <hook-env>/bin, set GOPATH to $PREGLIGIT_HOME/cache/go (#369)

Performance

Make Partitions iterator produce slice instead of Vec (#361)
Use rustc_hash (#359)

Bug fixes

Add node to PATH when running npm (#371)
Fix bug that default hook stage should be pre-commit (#367)
Fix cache dir permission before clean (#368)

Other changes

Move Project into workspace module (#364)

0.0.20

Enhancements

Support golang hooks and golang toolchain management (#355)
Add --last-commit flag to prefligit run (#351)

Bug fixes

Fix bug that directories are ignored (#350)
Use git ls-remote to fetch go releases (#356)

Documentation

Add migration section to README (#354)

0.0.19

Enhancements

Improve node support (#346)
Manage uv cache dir (#345)

Bug fixes

Add --install-links to npm install (#347)
Fix large file check to use staged_get instead of intent_add (#332)

0.0.18

Enhancements

Impl FromStr for language request (#338)

Performance

Use DFS to find connected components in hook dependencies (#341)
Use more Arc<T> over Box<T> (#333)

Bug fixes

Fix node path match, add tests (#339)
Skipped hook name should be taken into account for columns (#335)

Documentation

Add benchmarks (#342)
Update docs (#337)

0.0.17

Enhancements

Add sample-config --file to write sample config to file (#313)
Cache computed dependencies on hook (#319)
Cache the found path to uv (#323)
Improve sample-config writing file (#314)
Reimplement find matching env logic (#327)

Bug fixes

Fix issue that entry of pygrep is not shell commands (#316)
Support python311 as a valid language version (#321)

Other changes

Bump cargo-dist to 0.29.0 (#322)
Update DIFF.md (#318)

0.0.16

Enhancements

Improve error message for hook (#308)
Improve error message for hook installation and run (#310)
Improve hook invalid error message (#307)
Parse entry when constructing hook (#306)
Rename autoupdate to auto-update, init-templatedir to init-template-dir (#302)

Bug fixes

Fix end-of-file-fixer replaces \r\n with \n (#311)

0.0.15

In this release, language: node hooks are fully supported now (finally)!. Give it a try and let us know if you run into any issues!

Enhancements

Support nodejs language hook (#298)
Show unimplemented message earlier (#296)
Simplify npm installing dependencies (#299)

Documentation

Update readme (#300)

0.0.14

Enhancements

Show unimplemented status instead of panic (#290)
Try default uv managed python first, fallback to download (#291)

Other changes

Update Rust crate fancy-regex to 0.16.0 (#286)
Update Rust crate indicatif to 0.18.0 (#287)
Update Rust crate pprof to 0.15.0 (#288)
Update Rust crate serde_json to v1.0.142 (#285)
Update astral-sh/setup-uv action to v6 (#289)

0.0.13

Enhancements

Add PREFLIGIT_NO_FAST_PATH to disable Rust fast path (#272)
Improve subprocess error message (#276)
Remove LanguagePreference and improve language check (#277)
Support downloading requested Python version automatically (#281)
Implement language specific version parsing (#273)

Bug fixes

Fix python version matching (#275)
Show progress bar in verbose mode (#278)

0.0.12

Bug fixes

Ignore config not staged error for config outside the repo (#270)

Other changes

Add test fixture files (#266)
Use sync_all over flush (#269)

0.0.11

Enhancements

Support reading .pre-commit-config.yml as well (#213)
Refactor language version resolution and hook install dir (#221)
Implement prefligit install-hooks command (#258)
Implement pre-commit-hooks:end-of-file-fixer hook (#255)
Implement pre-commit-hooks:check_added_large_files hook (#219)
Implement script language hooks (#252)
Implement node.js installer (#152)
Use -v to show only verbose message, -vv show debug log, -vvv show trace log (#211)
Write .prefligit-repo.json inside cloned repo (#225)
Add language name to 'not yet implemented' messages (#251)

Bug fixes

Do not install if no additional dependencies for local python hook (#195)
Ensure flushing log file (#261)
Fix zip deflate (#194)

Other changes

Bump to Rust 1.88 and cargo update (#254)
Upgrade to Rust 2024 edition (#196)
Bump uv version (#260)
Simplify archive extraction implementation (#193)
Use astral-sh/rs-async-zip (#259)
Use ubuntu-latest for release action (#216)
Use async closure (#200)

0.0.10

Breaking changes

Warning: This release changed the store layout, it's recommended to delete the old store and install from scratch.

To delete the old store, run:

rm -rf ~/.cache/prefligit

Enhancements

Restructure store folders layout (#181)
Fallback some env vars to to pre-commit (#175)
Save patches to $PREFLIGIT_HOME/patches (#182)

Bug fixes

Fix removing git env vars (#176)
Fix typo in Cargo.toml (#160)

Other changes

Do not publish to crates.io (#191)
Bump cargo-dist to v0.28.0 (#170)
Bump uv version to 0.6.0 (#184)
Configure Renovate (#168)
Format sample config output (#172)
Make env vars a shareable crate (#171)
Reduce String alloc (#166)
Skip common git flags in command trace log (#162)
Update Rust crate clap to v4.5.29 (#173)
Update Rust crate which to v7.0.2 (#163)
Update astral-sh/setup-uv action to v5 (#164)
Upgrade Rust to 1.84 and upgrade dependencies (#161)

0.0.9

Due to a mistake in the release process, this release is skipped.

0.0.8

Enhancements

Move home dir to ~/.cache/prefligit (#154)
Implement trailing-whitespace in Rust (#137)
Limit hook install concurrency (#145)
Simplify language default version implementation (#150)
Support install uv from pypi (#149)
Add executing command to error message (#141)

Bug fixes

Use hook args in fast path (#139)

Other changes

Remove hook install_key (#153)
Remove pyvenv.cfg patch (#156)
Try to use D drive on Windows CI (#157)
Tweak trailing-whitespace-fixer (#140)
Upgrade dist to v0.27.0 (#158)
Uv install python into tools path (#151)

0.0.7

Enhancements

Add progress bar for hook init and install (#122)
Add color to command help (#131)
Add commit info to version display (#130)
Support meta hooks reading (#134)
Implement meta hooks (#135)

Bug fixes

Fix same repo clone multiple times (#125)
Fix logging level after renaming (#119)
Fix version tag distance (#132)

Other changes

Disable uv cache on Windows (#127)
Impl Eq and Hash for ConfigRemoteRepo (#126)
Make pass_env_vars runs on Windows (#133)
Run cargo update (#129)
Update Readme (#128)

0.0.6

Breaking changes

In this release, we’ve renamed the project to prefligit (a deliberate misspelling of preflight) to prevent confusion with the existing pre-commit tool. For further information, refer to issue #73.

The command-line name is now prefligit. We suggest uninstalling any previous version of pre-commit-rs and installing prefligit from scratch.
The PyPI package is now listed as prefligit.
The Cargo package is also now prefligit.
The Homebrew formula has been updated to prefligit.

Enhancements

Support docker_image language (#113)
Support init-templatedir subcommand (#101)
Implement get filenames from merge conflicts (#103)

Bug fixes

Fix prefligit install --hook-type name (#102)

Other changes

Apply color option to log (#100)
Improve tests (#106)
Remove intermedia Language enum (#107)
Run cargo clippy in the dev drive workspace (#115)

0.0.5

Enhancements

v0.0.4 release process was broken, so this release is a actually a re-release of v0.0.4.

Improve subprocess trace and error output (#92)
Stash working tree before running hooks (#96)
Add color to command trace (#94)
Improve hook output display (#79)
Improve uv installation (#78)
Support docker language (#67)

0.0.4

Enhancements

Improve subprocess trace and error output (#92)
Stash working tree before running hooks (#96)
Add color to command trace (#94)
Improve hook output display (#79)
Improve uv installation (#78)
Support docker language (#67)

0.0.3

Bug fixes

Check uv installed after acquired lock (#72)

Other changes

Add copyright of the original pre-commit to LICENSE (#74)
Add profiler (#71)
Publish to PyPI (#70)
Publish to crates.io (#75)
Rename pypi package to pre-commit-rusty (#76)

0.0.2

Enhancements

Add pre-commit self update (#68)
Auto install uv (#66)
Generate shell completion (#20)
Implement pre-commit clean (#24)
Implement pre-commit install (#28)
Implement pre-commit sample-config (#37)
Implement pre-commit uninstall (#36)
Implement pre-commit validate-config (#25)
Implement pre-commit validate-manifest (#26)
Implement basic pre-commit hook-impl (#63)
Partition filenames and delegate to multiple subprocesses (#7)
Refactor xargs (#8)
Skip empty config argument (#64)
Use fancy-regex (#62)
feat: add fail language support (#60)

Bug Fixes

Fix stage operate_on_files (#65)

FilesExpand file tree

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

0.3.8

Enhancements

Bug fixes

Contributors

0.3.7

0.3.6

Enhancements

Performance

Bug fixes

Documentation

Other changes

Contributors

0.3.5

Enhancements

Bug fixes

Other changes

Contributors

0.3.4

Enhancements

Bug fixes

Performance

Documentation

Contributors

0.3.3

Enhancements

Bug fixes

Documentation

Contributors

0.3.2

Highlights

Enhancements

Bug fixes

Documentation

Other changes

Contributors

0.3.1

Enhancements

Bug fixes

Documentation

Contributors

0.3.0

Highlights

Enhancements

Bug fixes

Documentation

Other Changes

Contributors

0.2.30

Enhancements

Bug fixes

Documentation

Contributors

0.2.29

Highlights

Enhancements

Bug fixes

Documentation

Contributors

0.2.28

Enhancements

Bug fixes

Documentation

Contributors

0.2.27

Highlights

Enhancements

Bug fixes

Other changes

Contributors

0.2.25

Performance

Bug fixes

Contributors