All NPK Commands & Flags | Nitro OS Documentation

Commands & Aliases Cheatsheet

NitroPkg (npk) provides intuitive subcommands and short single/double-letter aliases designed for fast terminal typing:

Command	Alias	Arguments	Description
install	`i`	<PACKAGE>	Installs one or multiple packages
remove	`rm`	<PACKAGE>	Uninstalls packages cleanly
search	`s`	<QUERY>	Searches packages by keyword or regex
update	-	-	Syncs package database from remote mirrors
upgrade	-	-	Upgrades all installed packages to latest
clean	-	-	Cleans cached download packages to reclaim disk
list	`ls`	[–installed]	Lists installed or orphan packages
help	`-h` `–help`	[COMMAND]	Displays help information and command flags

npk install / npk i (Install Packages)

Downloads and installs one or more packages from the configured Nitro OS repositories along with all required dependencies:

# Install a single package using full command
npk install firefox

# Install using short alias 'i'
npk i neovim

# Install multiple packages in a single transaction
npk i git curl ripgrep fzf zsh

# Non-interactive confirmation mode
npk i alacritty -y

npk remove / npk rm (Remove Packages)

Safely removes installed packages from your Nitro OS system, with dependency checking to prevent breaking other active packages:

# Remove a package using full command
npk remove firefox

# Remove using short alias 'rm'
npk rm vlc

# Remove package and clean unneeded orphaned dependencies
npk rm thunar --autoremove

npk search / npk s (Search Packages)

Searches all configured official repositories and mirrors for package names, keywords, and descriptions:

# Search packages by name or keyword
npk search waybar

# Search using short alias 's'
npk s rust

# Filter exact matches only
npk s --exact hyprland

npk update (Sync Database)

Refreshes and synchronizes local package metadata databases against active Nitro OS repository mirrors:

# Synchronize package databases
npk update

# Force refresh package databases
npk update --refresh

npk upgrade (System & Package Upgrades)

Upgrades all installed packages across your Nitro OS installation to their latest available repository versions:

# Perform full system rolling upgrade
npk upgrade

# Non-interactive upgrade with auto-confirm
npk upgrade -y

# Preview package upgrade changes without modifying system
npk upgrade --dry-run

npk clean (Clean Cache)

Frees disk space by removing obsolete downloaded package archives and build caches:

# Clean old package cache archives
npk clean

# Thoroughly purge entire cache directory
npk clean --all

npk list (List Installed Packages)

Inspects local package state, listing installed software, explicitly installed binaries, and orphaned packages:

# List all installed packages
npk list --installed

# List orphan packages no longer required by any installed application
npk list --orphans