Point chest at cluttered directories and watch them organize into structured compartments. Equipped with interactive dry-runs, instant rollbacks, and offline SQLite storage intelligence.
$ chest sort ~/Downloads -p downloads --dry-runCHEST PLAN # 3 moves, 0 collisions detected anime_ep01.mkv → Downloads/Videos/ profile_shot.png → Downloads/Images/ q3_financials.pdf → Downloads/Documents/3 files prepared to move. No changes made (dry run).Run with -y or omit --dry-run to apply.
Every operation is predictable. No hidden telemetry, no destructive overwrites, and no cloud latency.
Every transaction is logged in an undo database. Run chest undo to rollback the latest run or revert a specific operation by ID at any time.
Utilizes fastwalk parallel concurrency and fzf/src/algo scoring. Traverses 100,000+ files across all CPU cores, hash in parallel, and batch DB writes — with live in-place progress bars while you wait.
Watches folders via fsnotify with a 500ms debounce guard. Add --initial to sort what's already there before watching, and get instant feedback when folders are created or removed.
Pure-Go embedded SQLite stores file metadata and incremental SHA-256 hashes locally. Incremental indexing skips unchanged files on repeat runs, enabling instant duplicate checks and storage breakdowns.
Extensible via HashiCorp go-plugin over RPC. Community plugins execute in isolated subprocesses so third-party code cannot crash your core workflow.
Automatic resolution catches collisions before any disk write. Choose between skip, auto-rename, or interactive approval without risk of accidental data loss.
Blocks destructive operations on OS-critical directories (C:\Windows, /usr, drive roots) by default. Override with --allow-system and interactive confirmation.
Each verb is purpose-built with clean Unix ergonomics and structured JSON export options.
Categorizes target folder by preset, extension, or custom logic expressions with dry-run support.
Fuzzy filename scoring with in-file grep (line numbers + snippets). Combine category, extension, size, and date filters — or emit JSON for scripts.
Continuous background listener sorting newly downloaded files as soon as they settle.
Reverts file transfers by operation ID or rolls back the latest batch run instantly.
Finds exact byte-for-byte duplicate files across paths using incremental parallel SHA-256 hashes, with --except to skip noisy directories.
Generates storage allocation breakdowns, largest file rankings, and stale item diagnostics.
Installs shell tab-completion for bash, zsh, and fish in one command — auto-detects your shell and wires it into your profile.