Quick Start
This walkthrough uses the Downloads directory. Replace the path with the directory you want to organize.
1. Preview the plan
foldr ~/Downloads --preview
FOLDR shows the proposed organization without moving files. Check the source paths, destination folders, and any ignored files.
2. Apply the organization
foldr ~/Downloads
Review the plan and confirm when prompted.
3. Inspect operation history
foldr history
4. Undo the most recent operation
foldr undo
Undo checks the recorded operation before restoring files. It may skip a file when restoring it would overwrite a newer or modified file.
5. Watch the directory
foldr watch ~/Downloads
Watch mode processes existing files and monitors the directory for new arrivals. The watcher must be started again after a machine restart unless you separately configure your operating system to launch it.