Disk usage CLI for scanning directories quickly and cleaning up space from an interactive terminal UI.
$brew install dua-cli
AI Analysis
dua is a local disk-usage analyzer that scans filesystems in parallel and reports which paths consume space. It pairs a fast aggregate mode for terminal output with an interactive mode for browsing and deleting files or directories.
What It Enables
- Scan one or more paths to see which directories or files are using disk space, with options for byte units, apparent size, hard-link counting, ignore lists, and filesystem boundaries.
- Run quick aggregates over the current directory or explicit paths to triage build caches, logs, downloads, and other local storage hotspots.
- Open the interactive TUI to browse the tree, mark entries, and delete or trash unwanted files and directories.
Agent Fit
- The aggregate path is non-interactive and works for local inspect-and-decide loops, with predictable flags and exit codes.
- Automation is limited by human-readable output only; there is no
--jsonor structured export mode for reliable downstream parsing. - Best for agent-assisted local cleanup when simple text output is enough to identify the next action or a human can take over in the TUI.
Caveats
- Destructive actions live mainly in the interactive UI, which requires a connected terminal.
- It only operates on the local filesystem visible to the current machine.