Filecraft
A CLI organizer you didn't know you needed — yet.
Drop filecraft into any messy directory and watch it sort, rename, merge, and preview changes — all from your terminal, all reversible.
Everything you need, nothing you don't
Filecraft is designed to be minimal yet powerful — the right set of tools for developers who value clarity.
Smart Organize
Sort by extension, date, MIME type. Your directory structure, your way.
Smart Sorting
Seperate files into folders based on extension, date, MIME type. Your directory structure, your way.
Easy Renaming
Rename files with metadata, or sequential numbering.
Merge Directories
Pull files from multiple scattered directories into one clean destination with deduplication.
Dry-Run Preview
See exactly what will change before anything moves. Inspect every operation first.
Revert with History
Made a mistake? Every action is logged. Roll back any operation in seconds.
— All operations are composable
Chain commands together for powerful automation pipelines. Filecraft integrates seamlessly with shell scripts, cron jobs, and CI workflows.
filecraft separate --mode ext --dry-runThree steps to clarity
From chaos to clean in a single command. Filecraft handles the logic so you don't have to.
Messy Files
Your unorganized directory with random files of all types scattered around.
Filecraft CLI
Run a single command. Filecraft analyzes, plans, and previews changes.
Organized Folders
Files neatly placed into typed subdirectories. Clean, consistent, reversible.
# filecraft handles the restBuild your command
Toggle flags and watch the terminal output update live.
# live command preview
filecraft separate --mode extGet started in seconds
Filecraft requires Python 3.8+. Choose your preferred install method.
pipx install filecraft-cliRecommended — installs in an isolated environment
pip install filecraft-cliStandard Python package manager
yay -S filecraft-cliArch User Repository — for Arch-based distributions
yay -S filecraft-cli-binArch User Repository — for Arch-based distributions
Quick start after install
Built in public,
open to all.
Filecraft is fully open source under the MIT license. Report bugs, request features, submit PRs — contributions of all sizes are welcome. Check out the contribution guide to get started.
Available on PyPI,
pip-ready.
Install filecraft-cli with pip or pipx in seconds. Published on the Python Package Index, fully versioned with changelogs and semantic releases. Always stable, always auditable.
Available on AUR,
arch-ready.
Install filecraft-cli with pacman in seconds. Published on the Arch User Repository, fully versioned with changelogs and semantic releases. Always stable, always auditable.