Skip to content

Add FoldScan: macOS filesystem size scanner + duplicate folder finder - #1

Draft
bloomers7800 wants to merge 1 commit into
mainfrom
cursor/foldscan-macos-disk-platform-cf0d
Draft

Add FoldScan: macOS filesystem size scanner + duplicate folder finder#1
bloomers7800 wants to merge 1 commit into
mainfrom
cursor/foldscan-macos-disk-platform-cf0d

Conversation

@bloomers7800

Copy link
Copy Markdown
Owner

Summary

Adds FoldScan under foldscan/ — a macOS-friendly platform that:

  • Scans a directory tree and computes sizes at every directory level
  • Fingerprints folders (Merkle-style) to find large duplicate directory trees
  • Excludes iCloud / CloudStorage / common cloud sync paths by default
  • Provides a CLI (foldscan scan) and local web UI (foldscan serve)

Usage (macOS)

cd foldscan
./scripts/install-macos.sh
source .venv/bin/activate
foldscan scan ~
foldscan serve ~
  • --mode meta (default): fast size+mtime fingerprinting
  • --mode content: full SHA-256 for stronger duplicate proof
  • --min-size 50MB: only report large duplicates

Testing

cd foldscan && pip install -e ".[dev]" && pytest

All 8 tests passed in this environment.

Open in Web Open in Cursor 

Introduces a Python platform under foldscan/ that computes sizes at every
directory level, fingerprints folder trees to surface large duplicates,
excludes iCloud/cloud sync paths by default, and ships CLI plus local web UI.

Co-authored-by: bloomers7800 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants