Commands

Command	Description
nodehunter	Show help (default)
nodehunter help [cmd]	Help for a command or global options
scan	Discover node_modules directories (read-only)
size	Physical disk totals and largest projects
list	List projects or filter by package name
find	Locate package installs across the workspace
why	Package footprint — projects, versions, disk impact
inspect	Analytic lenses over workspace inventory
delete	Remove node_modules (requires confirmation)

Shared options

Commands that walk the filesystem accept discovery flags (-p, -D, -i, -nd, -L).

Listing-style commands (scan, size, list, find, why, inspect) also accept:

Flag	Description
--top <n>	Max rows to show (default 9; use --full for all)
--full	List every match with no cap

All commands accept global flags (--json, --quiet, --yes, …).

Choose a command

Goal	Start with
See every node_modules path	scan
Know how much disk is used	size
Rank projects by size	size or list
Find where react is installed	find react
Explain one package's footprint	why lodash
Duplicate versions, drift, risks	inspect
Reclaim space	size → delete

Narrative walkthroughs: Workflows.