Skip to the cargo

Ships in bottles: configuration examples ​

Pick a ship to start from, save its downloadable Pkl file as hk.pkl (yer ship's charts), and fit the tools and paths to yer own project. Each page carries the exact file it offers for download.

The ship in the bottleTools and ideas aboard
JavaScript and TypeScriptESLint, Prettier, and TypeScript checking if ye want it
PythonRuff linting and formatting, plus mypy if ye want it
A monorepo, one ship, many crewsComponent groups, inherited defaults, and several toolchains
Custom steps, hands ye sign on yerselfCheck/fix commands and self-contained step tests

Bring aboard any external tools the example calls on. Then validate and inspect the configuration before ye rig the hooks:

sh
hk validate
hk check --all --plan
hk install

For package environments and hooks launched from an editor, see mise integration, the quartermaster's berth. For each property on its own, see the configuration charts.

MIT LicenseCopyright © 2026jdx.dev