Quickstart¶

This page helps you get productive with prek in minutes, whether you are migrating from pre-commit or starting from scratch.

First follow the installation guide to install prek on your system.

I already use pre-commit I'm new to pre-commit-style tools

Already using pre-commit?¶

Great news - prek is designed as a drop-in replacement, you only need two tweaks:

1. Replace every pre-commit command in your scripts or documentation with prek. Your existing .pre-commit-config.yaml continues to work unchanged.

   $ prek run
   trim trailing whitespace.................................................Passed
   fix end of files.........................................................Passed
   typos....................................................................Passed
   cargo fmt................................................................Passed
   cargo clippy.............................................................Passed
   

2. Reinstall the Git shims once via prek install -f (run this if you previously executed pre-commit install).

From here you can explore what prek adds on top of pre-commit:

• Key differences and new features
• Built-in Rust-native hooks
• Workspace mode for monorepos

New to pre-commit-style workflows?¶

Follow this short example to experience how prek automates linting and formatting tasks.

1. Create a configuration¶

In the root of your repository, add a prek.toml:

[[repos]]
repo = "https://github.com/pre-commit/pre-commit-hooks"
rev = "v6.0.0"
hooks = [
  { id = "check-yaml" },
  { id = "end-of-file-fixer" },
]

This configuration uses the pre-commit-hooks repository and enables two hooks: check-yaml validates YAML files, and end-of-file-fixer ensures every file ends with a newline.

Add a small YAML file so the first run has something to check, then stage both files:

project: prek
enabled: true

git add prek.toml example.yaml

prek run checks the staged snapshot, so a new or changed config must be staged before this default run. You can still review or unstage it after trying the workflow.

2. Run hooks on demand¶

Use prek run to execute all configured hooks on the files in your current git staging area:

$ prek run
check yaml...............................................................Passed
fix end of files.........................................................Passed

The first run can take longer because prek downloads the hook repository and prepares its environment.

Need to run a single hook? Pass its ID, for example prek run check-yaml. You can also target specific files with --files, or run against the entire repository with --all-files. Use --all-files after adding or changing a hook to check existing files that are not staged.

3. Wire hooks into git automatically¶

To run the hooks every time you commit, install prek’s Git shim integration:

prek install

Now every git commit will invoke prek run for the files included in the commit. If you ever want to undo this, run prek uninstall.

4. Go further¶

• Explore richer configuration options in the official pre-commit documentation. Every example there works with prek.
• See Common Workflows for the commands you will use after setup and how to handle hook failures.
• Check the configuration reference for prek-specific settings.
• Browse the built-in hooks and the difference guide to see what else you can leverage.

That’s it! You now have automated checks running locally with minimal setup. When you’re ready to dive deeper, the rest of the docs cover advanced workflows, language-specific installers, and more.