Commands
This page summarizes the commands and options published for FOLDR. Replace <path> with the directory you want to organize. Quote paths that contain spaces.
Organize
Organize files in a directory. FOLDR displays a plan and asks for confirmation before moving files.
foldr <path>
Preview
Show the plan without moving files:
foldr <path> --preview
Recursive scanning
Include files in subdirectories:
foldr <path> --recursive
Limit recursive depth:
foldr <path> --recursive --depth 2
Ignore rules
Skip matching files for one run:
foldr <path> --ignore "*.log" "tmp/"
Disable ignore rules for one run:
foldr <path> --no-ignore
Show files that were ignored:
foldr <path> --show-ignored
Configuration
Use a specific configuration file:
foldr <path> --config myconfig.toml
Output
Print details for every file moved:
foldr <path> --verbose
Suppress normal output, for example in scripts or scheduled jobs:
foldr <path> --quiet
Duplicate removal
FOLDR supports three duplicate-retention strategies. Duplicate removal permanently deletes files and cannot be undone. Preview it before execution.
Preview duplicates while keeping the newest copy:
foldr <path> --dedup keep-newest --preview
Run the operation:
foldr <path> --dedup keep-newest
Available strategies:
| Strategy | Keeps | Removes |
|---|---|---|
keep-newest | Most recently modified copy | Older copies |
keep-oldest | Oldest copy | Newer copies |
keep-largest | Largest copy | Smaller copies |
Watch
Start watching a directory. FOLDR organizes existing eligible files and then monitors the directory for new arrivals:
foldr watch <path>
Include subdirectories:
foldr watch <path> --recursive
Watch in preview mode without moving files:
foldr watch <path> --preview
List active watchers:
foldr watches
Stop watching a specific path:
foldr unwatch <path>
Open the interactive watcher picker:
foldr unwatch
Undo
Undo the most recent organization operation:
foldr undo
Undo a specific operation by ID:
foldr undo --id a1b2c3
Preview what an undo operation would restore:
foldr undo --preview
Undo validates the recorded state and skips files when restoring them could overwrite later changes. Duplicate removal is not reversible.
History
List the most recent operations:
foldr history
List all recorded operations:
foldr history --all
Config
Show the configuration and data locations:
foldr config
Open the configuration file in the configured editor:
foldr config --edit
Open the global ignore file:
foldr config --edit --ignore-file