skip to content

// npm cli

dir-analysis-tool

A single-pass, streaming CLI for finding what is eating your disk.

dat walks a directory once, streams file hashes without loading files into memory, and reports the largest files, duplicated content, empty files and a breakdown by type, with a shareable HTML report.

npmsource
// folder10/21
year
2025
type
npm cli
group
developer tools
stars
8

the problem

//01the problem

Disk audits either load everything into memory or give you a wall of output you cannot act on or pipe anywhere.

how it works

//02how it works

  1. 01

    One walk, constant memory

    A single filesystem traversal with streaming MD5 hashing stays flat on multi-gigabyte trees.

  2. 02

    Actionable, not just accurate

    Duplicates come with wasted-space totals, plus large and empty file detection and a top-N list.

  3. 03

    Plays well with others

    Clean ANSI-free JSON, a progress bar that disables itself outside a TTY, CSV exports and a self-contained HTML report.

measured

//03measured

1,100+
npm downloads
in the last year
1
filesystem pass
streaming md5, constant memory on multi-gigabyte trees

highlights

//04highlights

  • 1,100+ npm downloads in the last year
  • Streaming duplicate detection
  • Automated releases with GitHub Actions

built with

  • TypeScript
  • Node.js
  • GitHub Actions
  • npm

//05contact

Say hello. I read everything.

Email is the fastest way to reach me. For anything that needs a conversation, book a call.

book a callsave contact

to

name
Khaled Saeed
email
contact@khaledsaeed.tech
country
Lebanon