macOS
Homebrewverified · 100%
brew install hkprovider-native install command
brew / rank 3132
Install hk with Homebrew
Git hook and pre-commit lint manager. Version 1.54.0 via Homebrew; verified 2026-07-31.
install
Additional install commands
overview
Package summary
Git hook and pre-commit lint manager
Project links
Commands and aliases
- generate-docs
- hk
history
Project history and usage
hk is a Rust git-hook manager and project lint runner by jdx, designed around fast hook execution, tighter linter integration, and safe parallelism through read/write file locking.
Project history
The official README describes hk as a git hook manager and project linting tool with an emphasis on performance. Its About page explains the motivation: git hooks need to be fast or developers stop using them, and naive parallel execution can break when multiple formatters or linters modify the same files.
hk's configuration model uses Apple's Pkl language through hk.pkl files. The configuration documentation describes layered sources, including built-in defaults, user-level hkrc, project config, Git config, environment variables, and CLI flags.
Adoption history
hk is a young tool in the git-hook manager space. The GitHub repository was created in January 2025, early GitHub releases began in March 2025, and the documentation quickly oriented around global Git hook installation, per-project hk.pkl files, and integration with mise-en-place.
The input package facts show packaging through Homebrew, MacPorts, and Scoop, which is a practical footprint for a developer CLI aimed at local workstations rather than servers.
How it is used
The intended workflow is to install hooks globally or per repository, run hk init to create hk.pkl, and then let Git events run configured lint and fix steps. hk check and hk fix provide explicit command-line entry points for running checks outside Git hooks.
The configuration docs emphasize precedence and local overrides: hk.local.pkl is for local changes that should not be committed, while ~/.config/hk/config.pkl can hold user-wide defaults.
Why package nerds care
hk matters to package nerds because it is part of the newer wave of developer workflow CLIs that try to make local checks fast enough to keep enabled. Its differentiator is not another hook file format by itself, but the combination of Pkl configuration, built-in linter definitions, libgit2 usage, mise integration, and locking around file modification.
It also reflects a packaging trend: single-purpose Rust CLIs distributed through Homebrew, Scoop, MacPorts, and direct release binaries for developers who want one binary in their path.
Timeline
- 2025-01-26: The jdx/hk GitHub repository was created.
- 2025-03-29: Early v0.6.x GitHub releases were published.
- 2025: hk documentation described global Git hook installation and hk.pkl project setup.
- 2026: hk documentation described pklr as the built-in Pkl evaluator and layered configuration sources.
Related projects
- mise-en-place: jdx's environment/tool-version manager that hk documentation names as an integration point.
- pre-commit, lefthook, Husky, lint-staged: adjacent git-hook and lint-running tools in the same developer workflow category.
- Pkl: Apple's configuration language used for hk.pkl.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
hk.local.pkl.config/hk.local.pklhk.pkl.config/hk.pkl~/.config/hk/config.pkl
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
generate-docs | executable | indexed executable | Discovered from the local executable index. |
hk | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version1.54.0
manager updated2026-07-31
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:hk |
|---|---|
| Version | 1.54.0 |
| Package manager | Homebrew |
| Homepage | https://hk.jdx.dev |
| Repository | https://github.com/jdx/hk |
| Last updated | 2026-07-31T07:14:45Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation