duf

15k

Disk usage CLI for listing mounted filesystems, free space, inode usage, and mount metadata.

$brew install duf
Language
Go
Stars
14,856
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

duf is a disk usage inspection CLI that reports mounted filesystem capacity, free space, usage percentages, and optional inode stats. It is essentially a more scriptable and readable df replacement for checking storage state on the current machine.

What It Enables
  • Inspect local, network, fuse, special, loop, or bind mounts and see size, free space, usage, filesystem type, and mount point.
  • Filter to specific filesystems or mount points, then sort or trim columns to focus on the disks relevant to an incident, preflight check, or host audit.
  • Export mount inventory and capacity data as JSON for follow-up parsing, alerts, or automated environment diagnostics.
Agent Fit
  • --json, predictable flags, and straightforward stderr or exit-code behavior make it easy to wrap in scripts when an agent needs storage state from the current host.
  • The scope is inspect-only and host-local, so it helps answer "what is full?" but does not manage partitions, volumes, or cloud disks.
  • Best used inside larger shell workflows for system checks, low-space debugging, and validation before running disk-heavy tasks.
Caveats
  • Default output is a human-oriented colored table, so automation should prefer --json or explicit --output selections.
  • It only reports mounts visible on the machine where it runs; remediation or remote storage actions still need other CLIs.