📊 dstat — Directory Statistics CLI

A fast, elegant CLI to analyze directory size, structure, and file statistics.
Built by Thrylo Labs.

🚀 Overview

dstat is a CLI utility that helps you understand what’s taking up space in your project directories. It gives you:

• 📁 Directory structure (Markdown-ready)
• 📦 File size stats (total, by extension, by folder)
• 🧠 Smart ignores (respects .gitignore, ignores node_modules, etc.)
• ✨ Optional JSON output, export to Markdown, and clipboard copy

📦 Installation

Make sure thry is installed first.

npm install -g @thrylolabs/thry

Install dstat.

thry install dstat

🧑‍💻 Usage

thry dstat [directory] [options]

Options

| Flag | Description | | ---------------------- | ---------------------------------------------- | | -t, --tree | Show directory structure tree | | -d, --depth <n> | Max depth for tree output | | -e, --exclude <list> | Exclude folders (comma-separated) | | -x, --ext | Show stats by file extension | | -i, --include-hidden | Include dotfiles and hidden folders | | -g, --gitignore | Respect .gitignore (default: enabled) | | -j, --json | Output stats in JSON format | | -c, --copy | Copy final report to clipboard | | -o, --output <file> | Export the report to a file (e.g., stats.md) | | -h, --help | Show help message |

🌿 Examples

# Basic stats of current directory
thry dstat .

# Show tree structure with depth of 2
thry dstat . -t -d 2

# Exclude common folders and show extension stats
thry dstat . -e node_modules,.git -x

# Export report to Markdown file
thry dstat . -o report.md

# Copy summary to clipboard
thry dstat . -c

📂 Sample Output

📊 Directory Stats for ./my-project

📁 Total Size: 3.1 MB
📄 Total Files: 182

🔡 Extension Breakdown:
  .js     → 45 files, 700 KB
  .ts     → 80 files, 1.3 MB
  .json   → 12 files, 200 KB

🗂 Tree (Depth 2)
my-project/
├── src/
│   ├── index.ts
│   └── utils.ts
├── public/
│   └── index.html
└── README.md

🛠 Built With

• TypeScript
• commander for CLI parsing
• fs-extra, globby, ignore, chalk
• clipboardy for copy feature
• pretty-bytes for human-readable sizes

🧠 About Thrylo Labs

Thrylo Labs builds fast, elegant, developer-first tools that push the boundaries of what's possible in modern computing.

Check out our work: https://github.com/ThryloLabs

📄 License

MIT © Thrylo Labs