npkg

Manage Nix profiles; helper commands support --help

npkg add bat

npkg <command> [args]

Some subcommands change stored data or packages. Check the selected operation before running.

Examples appear only where they add useful detail.

add [pkg ...]: Add package(s); with no args opens an fzf pickerAlso known as: install [pkg ...]
Example
npkg add bat
find [--] [query ...]: Fuzzy-pick nixpkgs attributes and add selections
Example
npkg find nvim
search <query>: Run a plain nixpkgs search with descriptions
Example
npkg search ripgrep
list: List packages in the current profile
remove [pkg ...]: Remove package(s); with no args opens an fzf picker
outdated: Compare installed and evaluated Nix output identities
refresh: Rebuild the cached nixpkgs attribute index
upgrade [pkg ...]: Upgrade all packages or only the named ones
help: Show this help text

Features and descriptions, with matching examples for npkg
Usage	Description	Example
`add [pkg ...]`	Add package(s); with no args opens an fzf pickerAlso known as: install [pkg ...]	`npkg add bat`
`find [--] [query ...]`	Fuzzy-pick nixpkgs attributes and add selections	`npkg find nvim`
`search <query>`	Run a plain nixpkgs search with descriptions	`npkg search ripgrep`
`list`	List packages in the current profile	No example documented
`remove [pkg ...]`	Remove package(s); with no args opens an fzf picker	No example documented
`outdated`	Compare installed and evaluated Nix output identities	No example documented
`refresh`	Rebuild the cached nixpkgs attribute index	No example documented
`upgrade [pkg ...]`	Upgrade all packages or only the named ones	No example documented
`help`	Show this help text	No example documented

Bare install names become nixpkgs#<name>; any option passes all add arguments to nix unchanged
npkg find searches a cached list of nixpkgs attribute names
npkg refresh and outdated need jq
Interactive add/find/remove needs jq and fzf 0.68.0+
refresh/outdated/check/diff accept no operands; -h/--help shows usage
find/pick/fzf recognizes -h/--help before --; after -- they are query text
Native add/remove/list/search/upgrade arguments pass through as documented
Advanced nix flags can be passed through by calling nix directly

Usage reference