Skip to content
Back to projects

Case study

Filemindr

A Python CLI that turns local file cleanup into a repeatable automation workflow.

Filemindr explores a practical automation problem: local folders fill with downloads, reports, exports, and temporary files, but cleanup is usually manual and inconsistent.

Rule-based organization instead of manual folder cleanup
Watch mode for recurring local automation
Reusable CLI shape for developer and data workflows

Problem

Local file workflows often start small and become noisy: exports, CSVs, PDFs, logs, and temporary files pile up across folders. Without explicit rules, every cleanup becomes a repeated manual decision.

Outcome

The project shows the same engineering instinct behind my data work: convert repetitive operational friction into a small, reliable tool with clear rules and practical feedback.

What I built

  • A Python CLI for organizing local files through transparent, rule-driven workflows.
  • A watch-oriented flow that can monitor folders and apply organization rules as files appear.
  • A package format that makes the tool installable, reusable, and suitable for repeated automation.

Technical decisions

  • CLI-first design so the tool can fit naturally into terminal, scripts, and scheduled routines.
  • Explicit rules to keep file movement predictable and easy to review.
  • Python packaging and PyPI distribution to make installation straightforward.

Filemindr demo

Try the organization flow

A small preview of the workflow Filemindr is designed for: files arrive in a local folder, rules match their names and extensions, and the output becomes easier to scan.

incoming folder
filemindr watch
filelocation
invoice-2025-08.pdf./Downloads
events-export.csv./Downloads
screenshot-home.png./Downloads
debug-run.log./Downloads

rules matched

*.pdf -> ./Documents/Invoices
*.csv -> ./Data/Exports
*.png -> ./Images/Screenshots
*.log -> ./Logs
Filemindr | Jeferson Peter