Repository navigation
-
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.