How zep4yrs/disksift works
DiskSift is a Tauri desktop disk-usage explorer and safety-focused cleanup tool. The main workflow is scan a volume, explore its size map/tree, classify directories, then clean or migrate selected data and review undo records. The README also documents AI advice, script management, Steam inspection, exclusions, and scheduled safe-only patrols. Sampled source confirms scanner, advisor, Steam inspection, monitoring, and migration behavior; wiring for several Rust commands and unsampled subsystems is represented only where the README documents it.
Main entry points: App.tsx DiskSift workbench · api.ts Desktop API · src/lib.rs Protected executor · src/lib.rs Disk scanner
Components 23
Scan and Explore
- DiskSift workbench
apps/desktop/src/App.tsx - Desktop API
apps/desktop/src/api.ts - Disk scanner
crates/scanner/src/lib.rs - NTFS MFT scan
crates/scanner/src/mft.rs - Tree and treemap
apps/desktop/src/components/TreeView.tsx
Triage and Scripts
- Rule triage
apps/desktop/src/triage.ts - AI triage
apps/desktop/src/triage-ai.ts - Cleanup scripts
crates/scaffold/src/lib.rs - Exclusion rules
crates/excludes/src/lib.rs
Safe File Actions
- Protected executor
crates/executor/src/lib.rs - Migration engine
crates/executor/src/move_engine.rs - Undo records
apps/desktop/src/components/RecordsView.tsx - Scheduled patrol
apps/desktop/src-tauri/src/auto_patrol.rs
Integrations
- AI advisor client
apps/desktop/src/advisorClient.ts - Steam inspector
crates/steam-inspector/src/lib.rs
Monitoring and State
- USN monitor
crates/monitor/src/lib.rs - Monitor event hook
apps/desktop/src/useMonitor.ts - Triage cache
apps/desktop/src/triage-cache.ts
Other components
- Desktop user
- AI providers
- Recycle bin
- Local volumes
- Windows scheduler
Connections 30
- Desktop user → DiskSift workbench: uses
- DiskSift workbench → Desktop API: requests operations
- Desktop API → Disk scanner: scans volume
- Disk scanner → NTFS MFT scan: uses NTFS path
- Disk scanner → Local volumes: reads metadata
- DiskSift workbench → Tree and treemap: renders scan tree
- DiskSift workbench → Rule triage: gets rule verdicts
- DiskSift workbench → AI triage: starts batch triage
- AI triage → AI advisor client: requests classification
- AI advisor client → AI providers: sends metadata prompts
- DiskSift workbench → Cleanup scripts: loads and manages scripts
- Rule triage → Cleanup scripts: uses script rules
- Disk scanner → Exclusion rules: prunes excluded paths
- DiskSift workbench → Desktop API: submits cleanup plan
- Desktop API → Protected executor: dispatches cleanup
- Protected executor → Exclusion rules: checks protected paths
- Protected executor → Recycle bin: moves deleted items
- Protected executor → Undo records: writes undo ledger
- DiskSift workbench → Desktop API: requests migration
- Desktop API → Migration engine: dispatches migration
- Migration engine → Local volumes: copies and verifies
- Windows scheduler → Scheduled patrol: starts safe-only run
- Scheduled patrol → Protected executor: dispatches cleanup
- DiskSift workbench → Monitor event hook: subscribes to events
- Monitor event hook → USN monitor: receives USN events
- USN monitor → Local volumes: watches NTFS journal
- Monitor event hook → DiskSift workbench: applies tree deltas
- DiskSift workbench → Triage cache: reads and writes verdicts
- DiskSift workbench → Steam inspector: requests inventory
- Steam inspector → Local volumes: reads Steam metadata