dua

5.7k

Disk usage CLI for scanning directories quickly and cleaning up space from an interactive terminal UI.

$brew install dua-cli
Language
Rust
Stars
5,666
Agent
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 --json or 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.