[logo after here]
Graceful File System Management, GracefulFS is a Window filesystem analysis tool.
GracefulFS is for Windows developers and power users who need to find large files, understand folder usage, and inspect disk consumption safely.
Please read the following documents before contributing:
- Select a local Windows drive or folder.
- Scan its contents without modifying any files.
- Collect file metadata and size information.
- Show folder usage and the largest files.
- Allow the user to monitor progress, cancel the scan, and exclude paths.
Included:
- Windows local drives and folders
- Read-only recursive scanning
- File size and basic metadata collection
- Folder usage summaries
- Large-file analysis
- Scan progress and cancellation
- Excluded paths
Excluded from the MVP:
- Automatic deletion or file movement
- Quarantine and recovery
- Duplicate-file detection
- Stale-file and history analysis
- Background monitoring and scheduled scans
- Network, cloud, and Docker storage analysis
- macOS and Linux support
- Desktop UI
The MVP never deletes, moves, or modifies user files. Any future cleanup action must require an explicit user-approved plan.
The initial target is Windows local storage. Exact Rust toolchain, Windows targets, and compatibility requirements are defined during the Rust foundation work.
Future versions may add indexing, duplicate and stale-file analysis, cleanup recommendations, safe file actions, recovery, history, monitoring, and a Windows desktop application.
See the GitHub milestones.