cli.md

CLI Reference

prek

Better pre-commit, re-engineered in Rust

Usage

prek [OPTIONS] [HOOK|PROJECT]... [COMMAND]

Commands

prek install

Install the prek git hook

prek install-hooks

Create hook environments for all hooks used in the config file

prek run

Run hooks

prek list

List available hooks

prek uninstall

Uninstall the prek git hook

prek validate-config

Validate .pre-commit-config.yaml files

prek validate-manifest

Validate .pre-commit-hooks.yaml files

prek sample-config

Produce a sample .pre-commit-config.yaml file

prek auto-update

Auto-update pre-commit config to the latest repos' versions

prek cache

Manage the prek cache

prek init-template-dir

Install hook script in a directory intended for use with git config init.templateDir

prek try-repo

Try the pre-commit hooks in the current repo

prek self

prek self management

prek install

Install the prek git hook

Usage

prek install [OPTIONS] [HOOK|PROJECT]...

Arguments

HOOK|PROJECT

Include the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Run all hooks with the specified ID across all projects

• project-path/: Run all hooks from the specified project

• project-path:hook-id: Run only the specified hook from the specified project

Can be specified multiple times to select multiple hooks/projects.

Options

--allow-missing-config

Allow a missing pre-commit configuration file

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--hook-type, -t hook-type

--install-hooks

Create hook environments for all hooks used in the config file

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--overwrite, -f

Overwrite existing hooks

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--skip hook|project

Skip the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Skip all hooks with the specified ID across all projects

• project-path/: Skip all hooks from the specified project

• project-path:hook-id: Skip only the specified hook from the specified project

Can be specified multiple times. Also accepts PREK_SKIP or SKIP environment variables (comma-delimited).

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek install-hooks

Create hook environments for all hooks used in the config file.

This command does not install the git hook. To install the git hook along with the hook environments in one command, use prek install --install-hooks.

Usage

prek install-hooks [OPTIONS] [HOOK|PROJECT]...

Arguments

HOOK|PROJECT

Include the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Run all hooks with the specified ID across all projects

• project-path/: Run all hooks from the specified project

• project-path:hook-id: Run only the specified hook from the specified project

Can be specified multiple times to select multiple hooks/projects.

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--skip hook|project

Skip the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Skip all hooks with the specified ID across all projects

• project-path/: Skip all hooks from the specified project

• project-path:hook-id: Skip only the specified hook from the specified project

Can be specified multiple times. Also accepts PREK_SKIP or SKIP environment variables (comma-delimited).

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek run

Run hooks

Usage

prek run [OPTIONS] [HOOK|PROJECT]...

Arguments

HOOK|PROJECT

Include the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Run all hooks with the specified ID across all projects

• project-path/: Run all hooks from the specified project

• project-path:hook-id: Run only the specified hook from the specified project

Can be specified multiple times to select multiple hooks/projects.

Options

--all-files, -a

Run on all files in the repo

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--directory, -d dir

Run hooks on all files in the specified directories.

You can specify multiple directories. It can be used in conjunction with --files.

--dry-run

Do not run the hooks, but print the hooks that would have been run

--fail-fast

Stop running hooks after the first failure

--files files

Specific filenames to run hooks on

--from-ref, --source, -s from-ref

The original ref in a <from_ref>...<to_ref> diff expression. Files changed in this diff will be run through the hooks

--help, -h

Display the concise help for this command

--hook-stage hook-stage

The stage during which the hook is fired

[default: pre-commit]

Possible values:

• manual
• commit-msg
• post-checkout
• post-commit
• post-merge
• post-rewrite
• pre-commit
• pre-merge-commit
• pre-push
• pre-rebase
• prepare-commit-msg

--last-commit

Run hooks against the last commit. Equivalent to --from-ref HEAD~1 --to-ref HEAD

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--show-diff-on-failure

When hooks fail, run git diff directly afterward

--skip hook|project

Skip the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Skip all hooks with the specified ID across all projects

• project-path/: Skip all hooks from the specified project

• project-path:hook-id: Skip only the specified hook from the specified project

Can be specified multiple times. Also accepts PREK_SKIP or SKIP environment variables (comma-delimited).

--to-ref, --origin, -o to-ref

The destination ref in a from_ref...to_ref diff expression. Defaults to HEAD if from_ref is specified

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek list

List available hooks

Usage

prek list [OPTIONS] [HOOK|PROJECT]...

Arguments

HOOK|PROJECT

Include the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Run all hooks with the specified ID across all projects

• project-path/: Run all hooks from the specified project

• project-path:hook-id: Run only the specified hook from the specified project

Can be specified multiple times to select multiple hooks/projects.

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--hook-stage hook-stage

Show only hooks that has the specified stage

Possible values:

• manual
• commit-msg
• post-checkout
• post-commit
• post-merge
• post-rewrite
• pre-commit
• pre-merge-commit
• pre-push
• pre-rebase
• prepare-commit-msg

--language language

Show only hooks that are implemented in the specified language

Possible values:

• conda
• coursier
• dart
• docker
• docker-image
• dotnet
• fail
• golang
• haskell
• lua
• node
• perl
• python
• r
• ruby
• rust
• swift
• pygrep
• script
• system

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--output-format output-format

The output format

[default: text]

Possible values:

• text
• json

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--skip hook|project

Skip the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Skip all hooks with the specified ID across all projects

• project-path/: Skip all hooks from the specified project

• project-path:hook-id: Skip only the specified hook from the specified project

Can be specified multiple times. Also accepts PREK_SKIP or SKIP environment variables (comma-delimited).

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek uninstall

Uninstall the prek git hook

Usage

prek uninstall [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--hook-type, -t hook-type

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek validate-config

Validate .pre-commit-config.yaml files

Usage

prek validate-config [OPTIONS] [CONFIG]...

Arguments

CONFIG

The path to the configuration file

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek validate-manifest

Validate .pre-commit-hooks.yaml files

Usage

prek validate-manifest [OPTIONS] [MANIFEST]...

Arguments

MANIFEST

The path to the manifest file

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek sample-config

Produce a sample .pre-commit-config.yaml file

Usage

prek sample-config [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--file, -f file

Write the sample config to a file (.pre-commit-config.yaml by default)

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek auto-update

Auto-update pre-commit config to the latest repos' versions

Usage

prek auto-update [OPTIONS]

Options

--bleeding-edge

Update to the bleeding edge of the default branch instead of the latest tagged version

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--dry-run

Do not write changes to the config file, only display what would be changed

--freeze

Store "frozen" hashes in rev instead of tag names

--help, -h

Display the concise help for this command

--jobs, -j jobs

Number of threads to use

[default: 0]

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--repo repo

Only update this repository. This option may be specified multiple times

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek cache

Manage the prek cache

Usage

prek cache [OPTIONS] <COMMAND>

Commands

prek cache dir

Show the location of the prek cache

prek cache gc

Remove unused cached repositories, hook environments, and other data

prek cache clean

Remove all prek cached data

prek cache size

Show the size of the prek cache

prek cache dir

Show the location of the prek cache

Usage

prek cache dir [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek cache gc

Remove unused cached repositories, hook environments, and other data

Usage

prek cache gc [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek cache clean

Remove all prek cached data

Usage

prek cache clean [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek cache size

Show the size of the prek cache

Usage

prek cache size [OPTIONS]

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--human, --human-readable, -H

Display the cache size in human-readable format (e.g., 1.2 GiB instead of raw bytes)

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek init-template-dir

Install hook script in a directory intended for use with git config init.templateDir

Usage

prek init-template-dir [OPTIONS] <DIRECTORY>

Arguments

DIRECTORY

The directory in which to write the hook script

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--hook-type, -t hook-type

Which hook type to install

Possible values:

• commit-msg
• post-checkout
• post-commit
• post-merge
• post-rewrite
• pre-commit
• pre-merge-commit
• pre-push
• pre-rebase
• prepare-commit-msg

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-allow-missing-config

Assume cloned repos should have a pre-commit config

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek try-repo

Try the pre-commit hooks in the current repo

Usage

prek try-repo [OPTIONS] <REPO> [HOOK|PROJECT]...

Arguments

REPO

Repository to source hooks from

HOOK|PROJECT

Include the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Run all hooks with the specified ID across all projects

• project-path/: Run all hooks from the specified project

• project-path:hook-id: Run only the specified hook from the specified project

Can be specified multiple times to select multiple hooks/projects.

Options

--all-files, -a

Run on all files in the repo

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--directory, -d dir

Run hooks on all files in the specified directories.

You can specify multiple directories. It can be used in conjunction with --files.

--dry-run

Do not run the hooks, but print the hooks that would have been run

--fail-fast

Stop running hooks after the first failure

--files files

Specific filenames to run hooks on

--from-ref, --source, -s from-ref

The original ref in a <from_ref>...<to_ref> diff expression. Files changed in this diff will be run through the hooks

--help, -h

Display the concise help for this command

--hook-stage hook-stage

The stage during which the hook is fired

[default: pre-commit]

Possible values:

• manual
• commit-msg
• post-checkout
• post-commit
• post-merge
• post-rewrite
• pre-commit
• pre-merge-commit
• pre-push
• pre-rebase
• prepare-commit-msg

--last-commit

Run hooks against the last commit. Equivalent to --from-ref HEAD~1 --to-ref HEAD

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--rev, --ref rev

Manually select a rev to run against, otherwise the HEAD revision will be used

--show-diff-on-failure

When hooks fail, run git diff directly afterward

--skip hook|project

Skip the specified hooks or projects.

Supports flexible selector syntax:

• hook-id: Skip all hooks with the specified ID across all projects

• project-path/: Skip all hooks from the specified project

• project-path:hook-id: Skip only the specified hook from the specified project

Can be specified multiple times. Also accepts PREK_SKIP or SKIP environment variables (comma-delimited).

--to-ref, --origin, -o to-ref

The destination ref in a from_ref...to_ref diff expression. Defaults to HEAD if from_ref is specified

--verbose, -v

Use verbose output

--version, -V

Display the prek version

prek self

prek self management

Usage

prek self [OPTIONS] <COMMAND>

Commands

prek self update

Update prek

prek self update

Update prek

Usage

prek self update [OPTIONS] [TARGET_VERSION]

Arguments

TARGET_VERSION

Update to the specified version. If not provided, prek will update to the latest version

Options

--cd, -C dir

Change to directory before running

--color color

Whether to use color in output

Possible values:

• auto: Enables colored output only when the output is going to a terminal or TTY with support
• always: Enables colored output regardless of the detected environment
• never: Disables colored output

--config, -c config

Path to alternate config file

--help, -h

Display the concise help for this command

--log-file log-file

Write trace logs to the specified file. If not specified, trace logs will be written to $PREK_HOME/prek.log

--no-progress

Hide all progress outputs.

For example, spinners or progress bars.

--quiet, -q

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which prek will write no output to stdout.

--refresh

Refresh all cached data

--token token

A GitHub token for authentication. A token is not required but can be used to reduce the chance of encountering rate limits

May also be set with the GITHUB_TOKEN environment variable.

--verbose, -v

Use verbose output

--version, -V

Display the prek version