Skip to content

CLI reference

Every command accepts --json and writes one JSON object to stdout. Global flags: --data-dir, --snapshot.

CommandPurpose
mish scan <path...>Scan and index paths (--incremental, --one-file-system, --follow-symlinks, --exclude <glob>, --apparent, --threads N)
mish daemonRun 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 dockerContainers, sizes, mounts (--stats)
mish export <snap>Export (--format csv|json)
mish snapshotslist, delete <id>, gc --keep N
mish configget, set <key> <value>
mish completions <shell>Shell completions
  • 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.

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 up
u | .. go to the parent g go to the snapshot root
o | <n> open child n s cycle the sort order
m cycle the metric + | - wider / narrower bars
q quit

--json emits one page as JSON and exits, so the same view is scriptable.

Terminal window
mish scan / --json
mish top / -n 25 --metric alloc --json
mish find / --size +1G --mtime -180d --json
mish diff <older> <newer> --json
mish snapshots gc --keep 3 --json