Skip to content

hk validate ​

  • Usage: hk validate [--json] [--deny-warnings]
  • Effect: read-only

Validate the config file

Errors for configs hk cannot run. Also prints warnings for settings that load but probably do not do what was meant: unknown properties (which release builds silently drop), depends that never orders anything, steps without a command, and globs that cannot match.

Flags ​

  • --json — Print the result as a JSON document on stdout
  • --deny-warnings — Exit with a non-zero status when the config has warnings
  • -h --help — Print help

Examples ​

Evaluate the selected configuration without running its linter commands.

sh
hk validate
HK_FILE=./hk.local.pkl hk validate

Learn more ​

Getting started · Troubleshooting · All commands

MIT LicenseCopyright © 2026jdx.dev