CLI reference
Every command accepts --json and writes one JSON object to stdout. Global flags: --data-dir,
--snapshot.
| Command | Purpose |
|---|---|
mish scan <path...> | Scan and index paths (--incremental, --one-file-system, --follow-symlinks, --exclude <glob>, --apparent, --threads N) |
mish daemon | Run the Unix-socket JSON-RPC daemon (--socket, --data-dir) |
mish ls [path] | List children (--sort, --limit) |
mish du [path] | Subtree sizes (--depth, --apparent) |
mish top [path] | Largest entries (-n, --kind, --metric alloc|apparent|items) |
mish find [path] | Filter by --size, --mtime, --ext, --owner, --dupe |
mish tree [path] | Print the hierarchy (--depth) |
mish tui [path] | Browse children as sized bars (--limit, --metric, --sort) |
mish ext [path] | Extension breakdown |
mish diff <a> <b> | Growth/shrink between snapshots |
mish docker | Containers, sizes, mounts (--stats) |
mish export <snap> | Export (--format csv|json) |
mish snapshots | list, delete <id>, gc --keep N |
mish config | get, set <key> <value> |
mish completions <shell> | Shell completions |
Metrics
Section titled “Metrics”- allocated (
sizeAlloc) — blocks actually consumed (st_blocks * 512); the default. - apparent (
sizeApparent) — logical file size.
Hardlinked files count once for allocated totals; sparse files report both metrics.
Terminal view
Section titled “Terminal view”mish tui [path] is the interective terminal view: it renders the children of a path as
sized bars and reads one line command at a time, so it works over SSH, inside a pipe and on
terminals without a termios layer. An empty line pages down; a bare number opens that child.
<enter> | j page down k page upu | .. go to the parent g go to the snapshot rooto | <n> open child n s cycle the sort orderm cycle the metric + | - wider / narrower barsq quit--json emits one page as JSON and exits, so the same view is scriptable.
Examples
Section titled “Examples”mish scan / --jsonmish top / -n 25 --metric alloc --jsonmish find / --size +1G --mtime -180d --jsonmish diff <older> <newer> --jsonmish snapshots gc --keep 3 --json