diskspace

The utility queries macOS system APIs to report the amount of free space on APFS volumes, avoiding the inaccuracies of traditional commands such as `du` or `df`. It can display several capacity metrics—including Available, Important, Opportunistic, and Total—mirroring the values shown in Finder and documented by Apple. Users may specify a target volume path, defaulting to the root filesystem, and choose a human‑readable format with unit suffixes.

Command‑line options let the user request a single metric or a full set of figures, making it suitable for scripts or interactive checks. The tool runs on macOS 10.14 and newer and is released under an open‑source license, with a stable release status.

Designed for developers, system administrators, and power users who need precise storage information on APFS disks, the program provides a straightforward interface to the underlying storage‑capacity APIs without requiring additional dependencies.