dot-clean

Remove .DS_Store, Thumbs.db, desktop.ini, and other OS-generated junk files recursively. Optionally update .gitignore to prevent them coming back. Zero dependencies.

Install

npm install -g dot-clean

Or without installing:

npx dot-clean

Usage

dot-clean                      # Remove macOS/Windows/Linux junk in current dir
dot-clean ~/Documents          # Clean a specific directory
dot-clean --dry-run            # Preview without deleting
dot-clean --all                # Remove all categories (incl. IDE/editor files)
dot-clean --type macos         # Only macOS junk
dot-clean --gitignore          # Also update .gitignore

Example Output

dot-clean  /my-project
  Scanning for: macos, windows, linux...

  ✗ screenshots/.DS_Store       4.1 kB
  ✗ screenshots/.DS_Store       4.1 kB
  ✗ backup/Thumbs.db            8.0 kB
  ✗ old-files/desktop.ini       402 B

  4 items removed  (16.6 kB freed)

Categories

| Category | Files removed | |---|---| | macos | .DS_Store, __MACOSX/, .AppleDouble, .Spotlight-V100, .Trashes, etc. | | windows | Thumbs.db, desktop.ini, ehthumbs.db, $RECYCLE.BIN, etc. | | linux | .fuse_hidden*, .directory, .Trash-*, .nfs* | | ide | .idea/, .vscode/, .classpath, .settings/, etc. | | editor | *~, *.bak, *.orig, *.swp, *.tmp |

Default: macos, windows, linux

Options

| Flag | Description | |---|---| | --type <list> | Comma-separated categories: macos,windows,linux,ide,editor | | --all | Remove all categories | | --dry-run | Show what would be removed, don't delete | | --gitignore | Update .gitignore to prevent future junk | | --stats | Show breakdown by category |

License

MIT

Keywords

.DS_Store · Thumbs.db · desktop.ini · remove junk files · clean os files · delete ds_store · mac junk · cleanup · cross-platform · zero dependencies

Built to solve, shared to help — Rushabh Shah 🛠️✨

One of 40+ zero-dependency developer CLI tools — no node_modules, ever.