Configuration¶

Prek is fully compatible with pre-commit configuration file .pre-commit-config.yaml, for example:

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v6.0.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer

  - repo: https://github.com/crate-ci/typos
    rev: v1.36.2
    hooks:
      - id: typos

Your existing configs work unchanged with prek.

For configuration details, refer to the official pre-commit docs: pre-commit.com

Environment variables¶

Prek supports the following environment variables:

• PREK_HOME — Override the prek data directory (caches, toolchains, hook envs). Defaults to ~/.cache/prek on macOS and Linux, and %LOCALAPPDATA%\prek on Windows.
• PREK_COLOR — Control colored output: auto (default), always, or never.
• PREK_SKIP — Comma-separated list of hook IDs to skip (e.g. black,ruff). See Skipping Projects or Hooks for details.
• PREK_ALLOW_NO_CONFIG — Allow running without a .pre-commit-config.yaml (useful for ad‑hoc runs). Also honored via PRE_COMMIT_ALLOW_NO_CONFIG.
• PREK_NO_CONCURRENCY — Disable parallelism for installs and runs. Also honored via PRE_COMMIT_NO_CONCURRENCY.
• PREK_NO_FAST_PATH — Disable Rust-native built-in hooks; always use the original hook implementation. See Built-in Fast Hooks for details.

Compatibility fallbacks:

• PRE_COMMIT_ALLOW_NO_CONFIG — Fallback for PREK_ALLOW_NO_CONFIG.
• PRE_COMMIT_NO_CONCURRENCY — Fallback for PREK_NO_CONCURRENCY.
• SKIP — Fallback for PREK_SKIP.