Skip to content

Refresh "Why prek" highlights - #2474

Merged
j178 merged 1 commit into
masterfrom
why-prek
Aug 3, 2026
Merged

Refresh "Why prek" highlights#2474
j178 merged 1 commit into
masterfrom
why-prek

Conversation

@j178

@j178 j178 commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Refreshes the “Why prek?” section with recent user-facing features from the changelog, including automatic fast paths, broader language support, run selectors, live hook output, and update safeguards.

Copilot AI review requested due to automatic review settings August 3, 2026 11:12
@j178 j178 added the documentation Improvements or additions to documentation label Aug 3, 2026 — with ChatGPT Codex Connector

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the README’s “Why prek?” section to reflect newer user-facing capabilities, aligning the project’s top-level positioning with recent feature work.

Changes:

  • Refreshes the performance bullets to highlight parallelism and priority aliases, plus the automatic fast path for supported hooks.
  • Expands the “easier to work with” bullets to cover broader language/toolchain support, groups, richer selection/filtering in prek run, and live hook output.
  • Updates the safeguards section to mention additional prek update features (cooldown holds, tag filtering, SHA freezing).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@j178 j178 changed the title Refresh Why prek highlights Refresh "Why prek" highlights Aug 3, 2026
@j178
j178 merged commit d5ec7be into master Aug 3, 2026
19 checks passed
@j178
j178 deleted the why-prek branch August 3, 2026 11:16
tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Aug 11, 2026
This MR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [prek](https://github.com/j178/prek) | tools | patch | `0.4.10` → `0.4.13` |

MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).

**Proposed changes to behavior should be submitted there as MRs.**

---

### Release Notes

<details>
<summary>j178/prek (prek)</summary>

### [`v0.4.13`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0413)

[Compare Source](j178/prek@v0.4.12...v0.4.13)

Released on 2026-08-10.

##### Highlights

##### Manage hook tools with mise

The new `language: mise` support lets hooks install tools using
[`mise`](https://mise.jdx.dev/) in an isolated environment:

```yaml
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:

```console
$ prek exec golangci-lint -- golangci-lint --version
```

##### Enhancements

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

##### Performance

- Avoid env cache scans for skipped hooks ([#&#8203;2502](j178/prek#2502))
- Cache Node version queries ([#&#8203;2500](j178/prek#2500))

##### Bug fixes

- Fix Node hook installation with npm 11 ([#&#8203;2487](j178/prek#2487))
- Isolate dependency installs from inherited Git repository state ([#&#8203;2506](j178/prek#2506))

##### Documentation

- Document combined group filtering ([#&#8203;2495](j178/prek#2495))
- Explain what prek does in README ([#&#8203;2507](j178/prek#2507))
- Refresh "Why prek" highlights ([#&#8203;2474](j178/prek#2474))

##### Contributors

- [@&#8203;will-wright-eng](https://github.com/will-wright-eng)
- [@&#8203;Repiteo](https://github.com/Repiteo)
- [@&#8203;j178](https://github.com/j178)

### [`v0.4.12`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0412)

[Compare Source](j178/prek@v0.4.11...v0.4.12)

Released on 2026-08-03.

##### Enhancements

- Add `--require-group` for hook group intersections ([#&#8203;2472](j178/prek#2472))
- Align fast-path and builtin pre-commit hooks ([#&#8203;2433](j178/prek#2433))
- Do not shuffle file list for verbose output ([#&#8203;2431](j178/prek#2431))
- Improve top-level command descriptions ([#&#8203;2429](j178/prek#2429))
- Install `uv` from Astral CDN and drop source racing ([#&#8203;2455](j178/prek#2455))
- Make `prek install --force` bypass external hooks paths ([#&#8203;2437](j178/prek#2437))
- Show builtin hook flags in verbose list output ([#&#8203;2427](j178/prek#2427))
- Verify uv release archive checksums ([#&#8203;2456](j178/prek#2456))

##### Performance

- Precompute file tags in parallel ([#&#8203;2440](j178/prek#2440))
- Skip diffs after known hook modifications ([#&#8203;2447](j178/prek#2447))
- Skip worktree diffs for read-only languages ([#&#8203;2432](j178/prek#2432))
- Track builtin hook file changes directly ([#&#8203;2404](j178/prek#2404))

##### Bug fixes

- Use full object IDs in diff snapshots ([#&#8203;2448](j178/prek#2448))

##### Documentation

- Add a multi-repository configuration example ([#&#8203;2434](j178/prek#2434))
- Rewrite benchmark documentation ([#&#8203;2469](j178/prek#2469))

##### Contributors

- [@&#8203;j178](https://github.com/j178)
- [@&#8203;BitWeaverDev](https://github.com/BitWeaverDev)
- [@&#8203;allanlewis](https://github.com/allanlewis)

### [`v0.4.11`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0411)

[Compare Source](j178/prek@v0.4.10...v0.4.11)

Released on 2026-07-25.

##### Highlights

- This release adds two new builtin hooks, `deny-pattern` and `require-pattern`,
  as native alternatives for `pygrep` use cases. `deny-pattern` fails when a
  configured pattern is found, while `require-pattern` ensures every selected
  file contains a match. By matching natively without spawning a Python
  subprocess, they run over 4x faster than `pygrep` in benchmarks. Note that
  they use
  [Rust `regex` syntax](https://docs.rs/regex/latest/regex/#syntax), which does
  not support look-around features such as negative lookbehind.

- `prek run` now supports `--glob <PATTERN>` to run hooks on tracked files
  matching a glob. It can be repeated or combined with `--files` and
  `--directory`.

- Hook priorities now support reusable aliases:

  ```toml
  [priorities]
  checks = 10

  [[repos]]
  repo = "builtin"
  hooks = [
    { id = "check-json", priority = "checks" },
    { id = "check-yaml", priority = "checks" },
  ]
  ```

  This makes parallel scheduling easier to read and maintain.

##### Enhancements

- Add `deny-pattern` and `require-pattern` builtin hooks ([#&#8203;2359](j178/prek#2359))
- Support `--glob` patterns in `prek run` ([#&#8203;2381](j178/prek#2381))
- Support reusable aliases for hook priorities ([#&#8203;2331](j178/prek#2331))
- Implement `requirements-txt-fixer` as a builtin hook ([#&#8203;2390](j178/prek#2390))
- Improve user-facing warnings and errors ([#&#8203;2380](j178/prek#2380))
- Install Node hooks through git url ([#&#8203;2394](j178/prek#2394))

##### Performance

- Reduce blocking-pool overhead in file hooks ([#&#8203;2384](j178/prek#2384))
- Speed up mixed-line-ending scans with memchr2 ([#&#8203;2391](j178/prek#2391))

##### Bug fixes

- Honor filenames in builtin hook entry and args ([#&#8203;2389](j178/prek#2389))
- Match identify tags across filename parts ([#&#8203;2399](j178/prek#2399))
- Preserve hook output order with a shared pipe ([#&#8203;2385](j178/prek#2385))
- Preserve system download policy when applying metadata ([#&#8203;2395](j178/prek#2395))

##### Contributors

- [@&#8203;j178](https://github.com/j178)
- [@&#8203;chrisoro](https://github.com/chrisoro)

</details>

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - At any time (no schedule defined)
- Automerge
  - At any time (no schedule defined)

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this MR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box

---

This MR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4yODYuMSIsInVwZGF0ZWRJblZlciI6IjQzLjI4OC4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJSZW5vdmF0ZSBCb3QiLCJhdXRvbWF0aW9uOmJvdC1hdXRob3JlZCIsImRlcGVuZGVuY3ktdHlwZTo6cGF0Y2giXX0=-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants