1.3k sao GitHub và vẫn tăng — jdx/hk là dự án Rust mà TopGit đang theo dõi trên nền tảng. git hooks and project lints
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
hk runs linters and fixers in parallel. Read/write file locks keep them from colliding when steps touch the same files, so concurrency within a run doesn't cost you correctness. Steps configured with stomp skip the locks, and separate hk processes don't share them. Use the same steps in Git hooks, from your terminal, and in CI.
Get started · Documentation · Built-in linters · CLI reference
Quick start
Install with mise, then run these commands inside your repository:
mise use hk
hk init
hk install
hk check --all
hk init detects project tools and generates hk.pkl. Review the selected linters and make sure their executables are available on PATH; hk configures how to run them, but does not install them. Use hk init --interactive to choose tools yourself.
On Git 2.54+, you can run hk install --global once to enable hk across repositories. Installed hooks exit silently in projects without an hk configuration. See installation options for older Git versions and mise environments.
You can also install hk with brew install hk or cargo install hk --locked. The default Pkl evaluator is built into hk; a separate Pkl installation is optional.
A configuration you can share
This example uses hk’s built-in whitespace utilities, so it needs no additional linter:
Top-level steps is the recommended starting point: hk supplies check, fix, and pre-commit hooks using these steps. It is optional; you can also define steps only inside explicit hooks. See hook defaults.
Add tools such as Builtins.oxfmt, Builtins.eslint, or Builtins.ruff, or define your own steps.
Everyday commands
Command
Use it to
hk check
Check modified files
hk fix
Apply available fixes to modified files
hk check --all
Check the repository, including in CI
hk check --plan
Preview selected files and steps without running them
hk check --why oxfmt
Explain why a step will run or be skipped
By convention, checks do not modify files. hk fix leaves fixes unstaged unless you pass --stage. The default pre-commit hook stashes unstaged work, fixes and stages changes, then restores the unstaged work. Review git diff and git diff --cached. Learn about hooks and partial commits.
Why hk?
Coordinate concurrent tools. File locks protect overlapping steps; diff and file-list checks reduce the work that needs exclusive access.
Both skills ship in the skills/ directory of each release archive. hk's packslip manifest points
to those directories, so compatible installers can use the bundled instructions without a separate
repository download. Making them available to an agent is
opt-in; see mise's skills documentation.
Contributing
See the contributing guide for development setup, tests, and review expectations. hk is released under the MIT license.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/jdx/hk là nguồn chính thức.
jdx/hk có phải mã nguồn mở không?
Có — jdx/hk phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/jdx/hk.
jdx/hk là gì?
jdx/hk (jdx/hk) là dự án Rust trên GitHub. Theo mô tả gốc: git hooks and project lints
Đọc đầy đủ README ở tab phía trên.
Chưa chắc hk có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về hk.