Skip to main content

Introduction

FOLDR is a command-line tool that organizes files into category folders based on their file extensions. It is designed to make file organization predictable: inspect a plan first, confirm before changes are applied, and use operation history when you need to undo an organization run.

A simple example​

report.pdf   → Documents/
photo.jpg    → Images/
movie.mp4    → Videos/
archive.zip  → Archives/

The core workflow​

  1. Scan a target directory for files that can be organized.
  2. Categorize files using the configured extension rules.
  3. Preview the planned source and destination paths.
  4. Confirm the operation.
  5. Record successful operations so they can be reviewed or undone.

What it includes​

  • Preview mode with --preview.
  • Undo and operation history.
  • Watch mode for directories that receive files over time.
  • Ignore rules and custom categories.
  • Duplicate removal with explicit strategies. This action is irreversible.

FOLDR is a local file-management tool. It does not need an account or a hosted service to organize files.

Next steps​