prek Files

Release Notes

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

Install prek 0.3.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Install prebuilt binaries via Homebrew

:::sh
brew install j178/tap/prek

Install prebuilt binaries into your npm project

:::sh
npm install @j178/prek@0.3.0

Download prek 0.3.0