skills.rest
void2610
void2610COMMUNITY
Explore all skills by this author →
Website𝕏@void2610GitHub

nix-pkg-update

Updates custom npm packages in a nix-config flake to their latest versions.

1|Updated Mar 12, 2025
Search Tags:#npm#nix#nix-darwin#package update#flake#darwin-rebuild#hash prefetch
One-click install
npx skills add https://github.com/void2610/dotfiles --skill nix-pkg-update-void2610
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nix-pkg-update
Source: https://github.com/void2610/dotfiles/tree/main/.claude/skills/nix-pkg-update
Command: npx skills add https://github.com/void2610/dotfiles --skill nix-pkg-update-void2610

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping custom npm packages defined as Nix derivations in ~/nix-config/pkgs/ up to date requires manually checking npm versions, prefetching tarball hashes, editing .nix files, and rebuilding with darwin-rebuild. This Skill automates that entire multi-step update workflow. ## Core Features & Use Cases - Version comparison: Reads the current version from the .nix file and compares it against the latest version published on the npm registry. - Hash management: Prefetches the new tarball's SRI hash with nix store prefetch-file, and handles npmDepsHash for buildNpmPackage derivations via the fakeHash build-error method. - Build and apply: Identifies the correct flake target from the machine's hostName, verifies the build with nix build, applies it with darwin-rebuild switch, and commits the change. - Use Case: You maintain uloop-cli and claude-code-ui as custom Nix packages. Run this Skill to bump uloop-cli from 1.6.3 to the latest release, update its hash, rebuild your nix-darwin configuration, and commit the result. ## Quick Start Update the uloop-cli package in my nix-config to the latest npm version and rebuild my system.

Frequently Asked Questions about nix-pkg-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an npm package defined in a Nix derivation?▼

Check the latest version with npm info, prefetch the new tarball hash using nix store prefetch-file, then update the version and hash fields in the .nix file. Finally rebuild with nix build and apply with darwin-rebuild switch.

How do I get the hash for a new npm tarball in Nix?▼

Run nix store prefetch-file --json with the registry tarball URL and parse the hash field from the JSON output. Match the --hash-type flag (sha256 or sha512) to the prefix used in the .nix file's hash attribute.

Why can't I prefetch npmDepsHash for buildNpmPackage?▼

npmDepsHash covers the entire npm dependency tree, not a single tarball, so it cannot be prefetched directly. Set it to pkgs.lib.fakeHash, run the build, and copy the correct value from the error's got: line.

How do I find the correct darwin-rebuild flake target?▼

The flake target is a key in darwinConfigurations, not the machine's hostname. Check scutil --get LocalHostName, then look up the matching hostName in nix-darwin/hosts/default.nix to find targets like game, work, or server.

Why does darwin-rebuild switch fail in a non-interactive environment?▼

darwin-rebuild switch requires a sudo password, which non-interactive shells often cannot supply. In that case, ask the user to run sudo darwin-rebuild switch --flake .#<target> manually from the nix-config directory.

Related Skills

Explore More Software Engineering Skills→
aster-voidaster-void

nix

Write Nix expressions and manage NixOS and home-manager configurations.

Community
Intermediate
authgearauthgear
2.0k

update_go_version

Update Go version references across go.mod, Dockerfiles, and Nix tooling.

Official
Intermediate
dnswddnswd

pi-mono-upgrade

Automate pi-mono upgrades in NixOS and nix-darwin dotfiles configurations.

Community
Advanced
ray-manalotoray-manaloto
1

mise-lang-node-packages

Pin Node package managers with corepack and mise for consistent tooling.

Official
Intermediate