🗺️ dirscape

Every place you can put data on a cluster, how full it is, and what changed since last time.

GPFS · Lustre · CephFS · XFS · NFS · anything with a mount table

You land on a new cluster. Where does 2 TB go? What gets purged on Friday? du cannot tell you, because du needs the path you are missing.

✨ Install

pip install dirscape
ds                  # or: dscape, dirscape

No dependencies and Python 3.6+, so the system Python on a login node is enough.

🧰 Use

ds                        # the table: arrows move, enter opens a row, esc goes back, q quits
ds why .                  # this directory: which quota it bills to, free space, file limit
ds new                    # what changed since the last run
ds recover results.csv    # snapshot copies of a deleted file, and how to restore one
ds stranded               # space you hold in filesets you can no longer reach
ds elsewhere              # allocations with no path on this node

🤖 For agents

ds paths --writable --kind scratch --min-free 2T   # filter the places
claude mcp add --scope user dirscape -- ds mcp     # register the MCP server once

Piped, ds prints the table and exits; an agent never gets the browser or moves the ds new baseline. Exit codes: 0 answered, 1 bad usage, 2 no place covers that path, 3 nothing found.

📌 Good to know

🛠️ For site administrators

dirscape --site-template > /etc/dirscape/site.conf writes a commented config that gives every user correct labels, purge warnings and quota backends. It grants nothing: access is measured live.

License

MIT