# jdx/hk

git hooks and project lints

Repository: https://github.com/jdx/hk
Canonical: https://ross.abutalabs.com/products/hk
Homepage: https://hk.jdx.dev
Language: Rust
License: MIT
License Family: permissive
Last push: 2026-09-02T22:05:53+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 88, longevity 41
- inputs: {"age_days": 584, "days_push": 0, "days_rel": 3, "gap_med": 1.0, "n_releases_24m": 141}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1143, forks 85 (observed 2026-09-03T02:15:13.110918+00:00)

## What it is
hk is a fast, language-agnostic git hook manager and project linter written in Rust. It runs linters and formatters concurrently with read/write file locking to prevent race conditions, and uses typed Pkl configuration with built-in definitions for common tools.

## Use cases
- manage git hooks for a project
- run linters and formatters in parallel on pre-commit
- prevent linters from racing when editing the same files
- safely handle partially staged files in pre-commit hooks
- set up global git hooks across all repositories
- run project lint checks in CI

## When to choose
- you need fast, parallel git hook execution with safe file locking
- you want built-in configurations for common linters like prettier or eslint
- you use mise and want integrated tool management
- you need robust stashing of unstaged changes during fix hooks

## When to avoid
- you need a hook manager with a large plugin ecosystem or broad community adoption
- you prefer YAML/JSON configuration over Pkl
- you only need simple sequential hook scripts
- you are on Git older than 2.54 and dislike legacy script shims

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, developer-tools, cli, concurrency, version-control
- domain: developer-tools, version-control
- platform: windows, cli, rust
- tags: git-hooks, linting, code-formatting, pre-commit, pkl-configuration, parallel-execution, mise-integration, command-line, automation, linux, macos

## Member repositories
- jdx/hk (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:13.110918+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:41:58.612981+00:00, confidence not recorded.
  - readme: https://github.com/jdx/hk (fetched 2026-09-03T02:15:13.110918+00:00, sha a7efefba46a2)
  - homepage: https://hk.jdx.dev (fetched 2026-08-29T12:45:47.279291+00:00, sha b7737dd12794)
  - site_page: https://hk.jdx.dev/cli/install.html (fetched 2026-08-29T12:45:47.281742+00:00, sha b20c3c7c141c)
  - site_page: https://hk.jdx.dev/cli/uninstall.html (fetched 2026-08-29T12:45:47.283460+00:00, sha eaf8f6de8afb)
  - site_page: https://hk.jdx.dev/about.html (fetched 2026-08-29T12:45:47.285069+00:00, sha c415bdaa617f)
  - registry_crates: https://crates.io/api/v1/crates/hk (fetched 2026-08-29T12:45:47.286612+00:00, sha 7cfa6b645b8a)
- Data as of 2026-08-30T08:39:29.467469+00:00.