Integrations¶
Use prek in container images and with coding agents. For GitHub Actions and other CI workflows, see Continuous Integration.
Docker¶
prek publishes container images under ghcr.io/j178/prek:
| Tags | Base | Contents |
|---|---|---|
X.Y.Z, X.Y, latest | scratch | The prek binary only |
X.Y.Z-alpine, X.Y-alpine, alpine | Current Alpine release | prek, Git, and CA certificates |
X.Y.Z-alpine3.24, X.Y-alpine3.24, alpine3.24 | alpine:3.24 | Version-pinned Alpine variant |
Note
Docker image tags before 0.4.10 include a leading v, for example ghcr.io/j178/prek:v0.4.9. The Alpine variant is available starting with 0.4.10.
Minimal (scratch)¶
The image is based on scratch (no shell, no package manager). It contains the prek binary at /prek.
A common pattern is to copy the binary into your own image:
If you prefer, you can also run the distroless image directly:
Alpine¶
The Alpine variant includes prek, Git, CA certificates, a shell, and the Alpine package manager.
Use X.Y.Z-alpine3.24 to pin both the prek and Alpine versions, or alpine3.24 to pin only the Alpine version while tracking the latest prek release. Tags without the numbered Alpine suffix, such as X.Y.Z-alpine and alpine, use the current supported Alpine release.
Verifying Images¶
All Docker image variants are signed with GitHub Attestations to verify they were built by official prek workflows. Verify using the GitHub CLI:
$ gh attestation verify --owner j178 oci://ghcr.io/j178/prek:latest
Loaded digest sha256:xxxx... for oci://ghcr.io/j178/prek:latest
Loaded 1 attestation from GitHub API
✓ Verification succeeded!
- Attestation #1
- Build repo:..... j178/prek
- Build workflow:. .github/workflows/build-docker.yml@refs/tags/vX.Y.Z
Tip
Use a specific version tag (e.g., ghcr.io/j178/prek:0.5.3) or image digest rather than latest for verification.
prek skill for agents¶
To let agents use prek, install the prek skill with gh skill (v2.90.0+):