| name | hermit-tooling |
| description | Use when a shell command in this repo fails with "command not found" for `just`, `buf`, `golangci-lint`, `goimports`, `lefthook`, `ruff`, or any other developer tool. The repo pins its toolchain via Hermit (`.hermit/`); the tools exist on disk but only resolve after the Hermit environment is activated. |
hermit-tooling
This repo uses Hermit to pin every developer tool (just, buf,
golangci-lint, goimports, ruff, lefthook, etc.) to a specific
version. The binaries live under .hermit/ and only join PATH after the
environment is activated.
What to do
- If a tool resolves to "command not found", activate Hermit:
source bin/activate-hermit
Verify with which just (or whatever was missing) — it should resolve
under the repo's .hermit/ path.
- If activation itself fails, fall back to running the tool via its full
path under
.hermit/python/bin/ etc. — do not install system-wide.
- For tools missing from
.hermit/ entirely, check bin/ for activation
shims; CONTRIBUTING.md "Hermit Setup" covers prerequisites.
What to avoid
- Don't
brew install, apt install, npm install -g, or pip install
to satisfy a missing tool. Hermit pins versions deliberately and a
system-wide install will mask drift.
- Don't add
--no-verify to commits because lefthook is missing —
activate Hermit instead.
