FileMayor

The intelligent, local-first engine for filesystem order.

v2.1.0 · Windows · macOS · Linux · Node ≥18 · Zero Dependencies

Website · npm · Safety Report

Why FileMayor?

Hacker News skeptics, we hear you. Why not du, find, or ncdu?

Unix tools are powerful but dangerous and manual. FileMayor provides a middle ground: Recursive context-aware intelligence paired with Psychological Safety.

• Intelligence: Don't just list files; analyze bloat, find duplicates across names, and auto-categorize into 12 smart categories.
• Safety: Every move is journaled. Every destructive action is dry-run by default. Every mistake is reversible.

Install

npm install -g filemayor

Quick Start

# Get deep insights into your disk bloat and duplicate waste
filemayor analyze ~/Downloads

# Preview a massive organization change without touching a bit
filemayor organize ~/Downloads --dry-run

# Reclaim space by nuking system junk and temporary rot
filemayor clean /var/tmp --yes

# Restore order if you change your mind
filemayor undo ~/Downloads

Features

• analyze (New): Deep intelligence. Fhash-based duplicate detection, top directory bloat mapping, and potential savings calculation.
• organize: Deterministic sorting into Documents, Images, Media, etc.
• clean: Multi-category junk removal (temp, cache, logs, system, dependencies).
• watch (Pro): Real-time background organization using a high-performance rules engine.
• undo: 100% cryptographic rollback of any organizational operation.

Security & Safety Protocols

We touch your files. We take that seriously.

1. 100% Local: No telemetry. No cloud uploads. No API calls to remote servers. Your file names and structures never leave your RAM.
2. Dry-Run by Default: Organization commands require an explicit execution or a --dry-run preview.
3. Rollback Journaling: Every move is recorded in a local .filemayor-journal.json. The undo command uses this to restore your filesystem state perfectly.
4. Supply-Chain Secured: Zero runtime dependencies. No hidden npm vulnerabilities. No node_modules rot in production.

Configuration

Control your engine with a simple .filemayor.yml:

organize:
  naming: category_prefix    # options: original | category_prefix | date_prefix | clean
  duplicates: rename         # options: rename | skip | overwrite
  ignore: [node_modules, .git, dist, build]

watch:
  directories: [~/Downloads]
  rules:
    - match: "*.pdf"
      action: move
      dest: ~/Documents/Finance

Pricing

FileMayor is built by builders for builders.

• Free: Core scanning, organization, cleaning, and undo.
• Pro: Real-time Watch mode, AI-powered SOP parsing, and Bulk processing.
• Activation: filemayor license activate FM-PRO-XXXX

Created by Lehlohonolo Goodwill Nchefu (Chevza)

Built for the builders who refuse to let digital rot win.