The filesystem is the foundation.
Treat it like one.
Every document, project, photo, and piece of work you have ever made lives somewhere on a filesystem. It is the oldest and most personal layer of computing. And for most people it is an unmanaged pile. FileMayor exists to fix that — carefully.
- 01
The mess is not your fault.
You do not lack discipline. You lack a tool that works with how humans actually accumulate files — in bursts, across contexts, without a predetermined taxonomy. Every productivity system that requires consistent upfront labelling is asking you to be a different person. FileMayor doesn't. It diagnoses what's already there and proposes a structure that fits what you made, not what you planned.
- 02
Reversibility is not a feature. It is the product.
The reason people don't clean up is not laziness. It's the cost of being wrong. A file moved to the wrong place — or a folder restructured in a way that breaks something downstream — is expensive to undo. So the rational response is to not touch it at all. FileMayor inverts this: the journal makes every session fully reversible, and undo --all costs exactly one command. When the cost of being wrong approaches zero, people act.
- 03
The AI proposes. You decide. The machine executes.
FileMayor is not autonomous. It will never run without approval. The AI reads your folder structure, reasons about it, and presents a plan in plain English. You read it, change whatever you want, and approve. Then the engine — not the AI — executes it, under six layers of safety checks. This is the right division of labour: AI for pattern recognition, human for judgement, software for precision.
- 04
Your files belong to you.
File contents never leave the machine. Not for analysis, not for training, not for any reason. The AI sees only what you'd see in a file listing: names, sizes, paths, extensions. That is enough to reason about structure. It is not enough to read your documents. This is a deliberate constraint, not a limitation.
- 05
Six layers is not paranoia.
An AI with write access to your filesystem is not a toy. We built the Chevza Doctrine — six independent safety layers, each with a single responsibility — because every previous design we tried put too much trust in a single check. Jail constrains scope. Guardrail inspects batches. Halt makes crashes safe. Architect validates semantic coherence. Security hardens input. These are not bullet points on a marketing page. They are the code that runs before anything moves.
- 06
Built by one person, in South Africa.
FileMayor is not a VC-backed startup optimising for growth metrics. It is a product built to be genuinely useful, priced to sustain the person who builds it, and designed to last. The code is the founding document: every decision in it is a decision about what kind of tool this is and what kind of relationship it has with the people who use it.
The things we said no to.
- —
Cloud sync
Your files stay on your machine. FileMayor is not a sync tool. It will never be a sync tool. The value is local-first, and that is not negotiable.
- —
Autonomous background organisation
Watch mode monitors folders and can trigger actions — but never without your approval. An AI that moves things without asking is not a tool you can trust.
- —
Opaque black-box AI decisions
The plan is always shown in plain English before anything runs. You can read it, edit it, and reject it. The AI is an advisor, not a decision-maker.
- —
Freemium dark patterns
The Free tier is genuinely useful. Pro unlocks more power, not basic functionality that was hobbled to force an upgrade. The pricing page says exactly what each plan includes.
- —
Growth over quality
There is no VC timeline, no growth-at-all-costs mandate. Features ship when they are right, not when they are good enough.
I built FileMayor because I kept putting off cleaning up my own filesystem — not because I didn't care, but because every previous attempt cost me more in mistakes than it saved in time. A script I wrote once moved the wrong folder and I spent an afternoon recovering. After that I didn't touch it for six months.
The real problem wasn't the script. It was that there was no undo. FileMayor started as a journal. Everything else — the AI, the command bar, the MCP server — came after the journal was solid. That's still the order of priority: safety first, power second.
If you find something wrong with it, email me. I read every message.