https://github.com/j178/prek
⚡ Better `pre-commit`, re-engineered in Rust
https://github.com/j178/prek
git git-hooks pre-commit
Last synced: 3 months ago
JSON representation
⚡ Better `pre-commit`, re-engineered in Rust
- Host: GitHub
- URL: https://github.com/j178/prek
- Owner: j178
- License: mit
- Created: 2024-10-07T08:21:29.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-08-08T16:44:51.000Z (3 months ago)
- Last Synced: 2025-08-08T18:35:34.909Z (3 months ago)
- Topics: git, git-hooks, pre-commit
- Language: Rust
- Homepage:
- Size: 1 MB
- Stars: 272
- Watchers: 6
- Forks: 20
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# prek
[](https://github.com/j178/prek/actions/workflows/ci.yml)
[](https://github.com/j178/prek/releases)
[](https://discord.gg/3NRJUqJz86)
[pre-commit](https://pre-commit.com/) is a framework to run hooks written in many languages, and it manages the
language toolchain and dependencies for running the hooks.
prek is a reimagined version of pre-commit, built in Rust.
It is designed to be a faster, dependency-free and drop-in alternative for it,
while also providing some additional long-requested features.
> [!WARNING]
> This project was previously named `prefligit`, but it has been renamed to `prek` to avoid typosquatting issues.
> [!WARNING]
> This project is still in early stage of development, some features are still not implemented.
> It is not production-ready yet, but feel free to try it out and provide feedback.
>
> Current supported languages are `python`, `node`, `go`, `docker`, `docker-image`, `pygrep`, `system`, `script` and `fail`.
## Features
- 🚀 A single binary with no dependencies, does not require Python or any other runtime.
- ⚡ About [10x faster](https://github.com/j178/prek/blob/master/BENCHMARK.md) than `pre-commit` and uses only a third of disk space.
- 🔄 Fully compatible with the original pre-commit configurations and hooks.
- 🐍 Integration with [`uv`](https://github.com/astral-sh/uv) for managing Python virtual environments and dependencies.
- 🛠️ Improved toolchain installations for Python, Node.js, Go, Rust and Ruby, shared between hooks.
- 📦 Built-in implementation of some common hooks.
- 🏗️ (TODO) Built-in support for monorepos.
## How to migrate
prek is designed as a drop-in replacement:
- [Install prek](#installation)
- Replace `pre-commit` with `prek` in your commands
- Your existing `.pre-commit-config.yaml` works unchanged
```console
$ prek run
trim trailing whitespace.................................................Passed
fix end of files.........................................................Passed
typos....................................................................Passed
cargo fmt................................................................Passed
cargo clippy.............................................................Passed
```
For configuring `.pre-commit-config.yaml` and writing hooks, you can refer to the [pre-commit documentation](https://pre-commit.com/) as prek is fully compatible with it.
## Why prek?
### prek is way faster
- It is about [10x faster](https://github.com/j178/prek/blob/master/BENCHMARK.md) than `pre-commit` and uses only a third of disk space.
- It redesigned how hook environments and toolchains are managed, they are all shared between hooks, which reduces the disk space usage and speeds up the installation process.
- Repositories are cloned in parallel, and hooks are installed in parallel if their dependencies are disjoint.
- It uses [`uv`](https://github.com/astral-sh/uv) for creating Python virtualenvs and installing dependencies, which is known for its speed and efficiency.
- It implements some common hooks in Rust, built in prek, which are faster than their Python counterparts.
### prek provides a better user experience
- No need to install Python or any other runtime, just download a single binary.
- No hassle with your Python version or virtual environments, prek automatically installs the required Python version and creates a virtual environment for you.
- (TODO): Built-in support for workspaces (or monorepos), each subproject can have its own `.pre-commit-config.yaml` file.
- `prek run` has some improvements over `pre-commit run`, such as:
- `prek run --directory ` runs hooks for files in the specified directory, no need to use `git ls-files -- | xargs pre-commit run --files` anymore.
- `prek run --last-commit` runs hooks for files changed in the last commit.
- `prek list` command lists all available hooks, their ids, and descriptions, providing a better overview of the configured hooks.
- prek provides shell completions for `prek run ` command, making it easier to run specific hooks without remembering their ids.
## Installation
Standalone installer
prek provides a standalone installer script to download and install the tool:
```console
# On Linux and macOS
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.0.24/prek-installer.sh | sh
# On Windows
powershell -ExecutionPolicy ByPass -c "irm https://github.com/j178/prek/releases/download/v0.0.24/prek-installer.ps1 | iex"
```
PyPI
prek is published as Python binary wheel to PyPI, you can install it using `pip`, `uv` (recommended), or `pipx`:
```console
pip install prek
# or
uv tool install prek
# or
pipx install prek
```
Homebrew
```console
brew install j178/tap/prek
```
Cargo
Build from source using Cargo:
```console
cargo install --locked --git https://github.com/j178/prek
```
GitHub Releases
prek release artifacts can be downloaded directly from the [GitHub releases](https://github.com/j178/prekprek/releases).
If installed via the standalone installer, prek can update itself to the latest version:
```console
$ prek self update
```
## Acknowledgements
This project is heavily inspired by the original [pre-commit](https://pre-commit.com/) tool, and it wouldn't be possible without the hard work
of the maintainers and contributors of that project.
And a special thanks to the [Astral](https://github.com/astral-sh) team for their remarkable projects, particularly [uv](https://github.com/astral-sh/uv),
from which I've learned a lot on how to write efficient and idiomatic Rust code.