How mamguitar2/tidylocal works
TidyLocal is a local-only macOS file review and organization app. The user selects approved locations and starts a read-only scan; the dashboard presents storage, file-age, and exact-duplicate findings, while Organize offers conservative suggestions and requires a separate confirmation for each action. The API coordinates scanning and guarded filesystem operations, with activity logging and identity-checked undo. The README documents optional app inventory and opt-in Ollama explanations; the sampled source confirms their modules, but not all route wiring, so those links are documented or marked optional.
Main entry points: app.py Local API · app.js Dashboard UI · undo.py Move and folder undo · operations.py Guarded filesystem actions
Components 16
Local interface
- Local launcher
launch.py - Dashboard page
templates/index.html - Dashboard UI
static/app.js - Review charts
static/charts.js - Duplicates and age UI
static/duplicates.js - Organize review UI
static/organize-ui.js
Scan and review
- Local API
app.py - Approved-location scanner
scanner.py - Suggestion and text classifier
organizer.py
Safe file actions
- Guarded filesystem actions
operations.py - Move and folder undo
undo.py - Local activity log
Local integrations
- macOS app inventory
applications.py - Opt-in explanation helper
ollama_local.py - Loopback Ollama
Other components
- Mac user
Connections 20
- Mac user → Local launcher: launches
README.md - Local launcher → Local API: starts server
launch.py - Mac user → Dashboard UI: reviews
README.md - Dashboard page → Dashboard UI: hosts interface
README.md - Dashboard UI → Local API: requests scans
static/app.js - Dashboard UI → Review charts: renders charts
- Duplicates and age UI → Local API: requests file actions
static/duplicates.js - Organize review UI → Local API: requests organizing
README.md - Local API → Approved-location scanner: starts scan
app.py - Approved-location scanner → Suggestion and text classifier: uses file descriptions
scanner.py - Local API → Suggestion and text classifier: requests suggestions
README.md - Local API → Guarded filesystem actions: executes actions
app.py - Guarded filesystem actions → Suggestion and text classifier: resolves folders
operations.py - Local API → Move and folder undo: requests undo
app.py - Move and folder undo → Guarded filesystem actions: restores moves
undo.py - Local API → Local activity log: reads and logs
app.py - Move and folder undo → Local activity log: reads and logs
undo.py - Local API → macOS app inventory: lists applications
README.md - Local API → Opt-in explanation helper: requests explanations
app.py - Opt-in explanation helper → Loopback Ollama: posts metadata
ollama_local.py