Repository navigation
Releases
v0.4.0
-
Standalone
package.nix(pkgs.callPackage ./package.nix { }) bundles the
CLI, release/PR helpers, overlay expressions and built web dashboard into
one derivation with offlinefetchNpmDepsandnix-detour --version. -
nix-detour checkkeeps each PR entry'suntilChannelunless--channel
is passed;pr add,pr pinandpr removetake a file lock so concurrent
runs don't overwrite each other's entries. -
pr add: shorthand syntax accepts PR number or GitHub pull request URL
directly (pr add 587609orpr add <url>), auto-detecting fork repository,
package attributes (frompkgs/by-name), NixOS modules, and latest commit
SHA from GitHub. Supports--pinand--no-pin. -
pr pin: omitting the commit SHA re-pins the entry to its latest head commit
from GitHub;--allupdates all active entries in the file in one command. -
pr check: upstream PR state and channel landing checks run concurrently in
parallel. -
Update action: lists holds a target still has unheld (new
unreached
output and report section), from a package set the holds overlay doesn't
reach. On 2026-11-11 a buzz-cli hold changed nothing: cadre's home-manager
module installed buzz-app from its own flake'spackages.lib.watch.unreached
is the check in Nix. -
Update action:
skip-unmoved: truedoes nothing unless the lock moves
inputfrombase's revision (newmovedoutput), so the action can run
on every PR that touches the lock. On 2026-11-11 a hand-made nixpkgs bump
in kleinbem/nix-config#737 broke five packages that no update run saw. -
hold-release action:
open-prs: falseonly checks, and the newheld
output lists the holds that still fail. Pass another system'sheldto
keepso a hold goes only when it builds on every system you use.
tokenis needed only when the action opens PRs. -
Update action: a failed download is not a broken package. Builds use
--fallback, a failed build is retried once on its own, and one that
still fails on a network error (a 5xx or 429 from a cache or source,
DNS, connect, timeout) is reported asunavailableand never held. A
404 still counts as broken. On 2026-11-02 a 502 from a binary cache
would otherwise have been reported as a package to hold. -
Update action: commit mode commits only onto the commit it checked out,
which on a pull_request event must be the PR head (not the merge commit);
a push to the branch during the run fails the commit instead of putting
holds checked on the old lock onto the new one. The check compares
commits: abranchwhose head is another commit fails. Withholds-repo
the holds go into a new PR there, so this check doesn't apply. The previous nixpkgs comes
from theflakedirectory's flake.lock (it was the repository root's),
and the token falls back to the workflow's, so report mode can clone a
publicholds-repowithout one. -
pr-pin action:
revmust be a full commit SHA. pr-merged action: the PRs
file is left as it is on the branch for later steps. The actions' commits
work on macOS runners too. -
hold check: a hold with a malformedsinceis still checked. -
PRs: an entry's
pythonPackagesgo into every Python package set (from
pkgs/development/python-modules/<name>, orpaths."python3Packages.<name>"),
finding the entry's own packages first. A scope frompaths(a
makeScopelikemesh-llmPlugins) works as before, and the checks now
list its packages one by one (<scope>.<name>), sopr evaland
mergedcover each of them. -
PRs:
mergedneeds a version on both sides. A PR package without a version
stays until you remove its entry, instead of counting as merged as soon as
nixpkgs has the attribute. -
Update action:
build: fetchesbuilds only the fixed-output derivations
(sources, vendored dependencies) of the watched packages no substituter
has. A hash mismatch never shows in an evaluation; this finds it without
compiling the packages, and the report has the hash nix got. -
Fixes: a held package can carry
patches(URLs pinned by hash, or files
next to the holds file) and anoverridefile, andfrom = "current"
fixes the package of your own nixpkgs instead of holding an older one.
A fix ends like a hold, once the unfixed package builds from
nixos-unstable. CLI:nix-detour fix add NAME --patch … | --override …
(and--patch,--override,--from currentonhold add). -
Web dashboard: holds, fixes, PRs (including shorthand auto-detection and
pythonPackages) and releases go through the CLI, so revisions, patch URLs
and PR head commits are pinned by hash. Supports light and dark themes, font
scaling, native<dialog>modals, TTL-cached PR status checks, and true
empty local files without loading sample data over them. The server refuses
cross-site requests, and imported data stays in the page instead of writing
to disk.
v0.3.1
-
Update action with
holds-repo: the holds repository is cloned at the
revision the flake's lock has forholds-input, so the checks see the
holds the lock update was validated with. A failing package the
repository holds by now is reported as "update the input" instead of
proposed again (and left out of commit mode's PR). -
Update action: when the base branch's flake.lock can't be read (no git
checkout, unknown input), it says so instead of stopping with exit 128.
v0.3.0
Renamed from nix-holds: single packages take a detour from your nixpkgs,
held back while broken or ahead from an open nixpkgs PR, until nixpkgs
catches up.
- The repository is
kleinbem-dev/nix-detour. Web, git and flake URLs
redirect; GitHub Actions'uses:doesn't, so workflows change
kleinbem-dev/nix-holds@tokleinbem-dev/nix-detour/hold-release@and
kleinbem-dev/nix-holds/<action>@tokleinbem-dev/nix-detour/<action>@. - CLI
nix-detour: holds are undernix-detour hold(add,remove,
list,check), next tonix-detour pr. The old top-level commands say
where they went. - The holds' release action is
kleinbem-dev/nix-detour/hold-release, next
topr-pin,pr-mergedandupdate. - Update action (
kleinbem-dev/nix-detour/update): on a lock-update PR, it
finds what the update broke and holds each package on the nixpkgs before
the update, in the same PR (mode: commit) or as a report. After each
round it checks again: what still fails held is reported, not held, and a
failure that shows up only then is held next round (up to 5).- What it checks: targets (
nixDetourTargets,lib.watch.target host),
where the package to hold is found in the error's trace however the host
reaches it; and watched packages (nixDetourWatch,lib.watch.nixosor
lib.watch.packages), each evaluated on its own and built when no
substituter has it. The old output namesnixHoldsWatchand
nixHoldsTargetsstill work, with a warning. - Holds kept in another repository:
holds-repo,holds-inputand
holds-token. It clones that repository, checks through
--override-input, and in commit mode opens a PR there with only its new
holds on top of the file as it is then. directoryandnix-argscover a checkout in a subfolder and flakes
that need--override-input;systemschecks other systems' hosts from
the same runner (evaluation only).- Outputs
held,failedand a Markdownreport.
- What it checks: targets (
v0.2.0
- Packages from open nixpkgs PRs:
lib.mkPrs { prs }(or plain
import ./prs.nix) builds the packages and NixOS modules of the PRs in a
nixpkgs-prs.jsonagainst your nixpkgs (overlay,packages,
nixosModules,checks). - CLI:
nix-holds pr add,pin,remove,list,eval,merged. - Actions:
kleinbem-dev/nix-holds/pr-pinpins an entry and opens the PR;
kleinbem-dev/nix-holds/pr-mergedopens a PR removing each entry nixpkgs
has caught up with.
v0.1.0
First version for use outside the kleinbem fleet.
lib.mkHolds { holds, nixpkgs-stable, extraOverlays, config }: your own
holds file givesoverlay,nixosTestsandreleaseChecks.- The held package sets get your nixpkgs config (allowUnfree, insecure
packages, CUDA/ROCm, ...) instead of a forcedallowUnfree = true. - Release checks build with your own overlays, so holds of your own
packages can be released too. - Release action (
uses: kleinbem-dev/nix-holds@<sha>): opens a PR per hold that
can go; itsstaleoutput lists the old ones. - CLI:
nix-holds add,remove,list,check
(nix run github:kleinbem-dev/nix-holds), for Linux and aarch64-darwin. - Release checks carry their hold (
nixHolds), socheckand the action
read the holds the flake actually uses. - Pinned revisions are fetched with
fetchTarball, so the overlay works
without the flakes feature. - Removed: the kleinbem fleet's own holds and the outputs built from them
(overlays.default,lib.mkOverlay,lib.nixosTests); they live in
kleinbem/nix-holds-fleet.