---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# nh

> Modern helper utility tool for the Nix/Nixos ecosystem.
> More information: <https://github.com/nix-community/nh#usage>.

- Search for a package in Nixpkgs, limiting results:

`nh search {{[-l|--limit]}} {{number}} {{name}}`

- Collect all garbage and gcroots from the Nix store:

`nh clean all {{[-a|--ask]}}`

- Build a specified Nixos flake configuration and create a symlink of the result from the Nix store:

`nh os build-vm {{path/to/flake}} {{[-H|--hostname]}} {{host}}`

- Build and test a specified Nixos flake configuration:

`nh os test {{path/to/flake}} {{[-H|--hostname]}} {{nixos}}`

- Build and switch to a specified Home manager flake configuration:

`nh home switch {{path/to/flake}} {{[-c|--configuration]}} {{home}}`

- Build and switch to a nix-darwin flake configuration:

`nh darwin switch {{path/to/flake}} {{[-H|--hostname]}} {{host}}`

- Generate shell completions for a specified shell:

`nh completions {{shell}}`