Summary
Exposes file organization capabilities from the fileman project as an MCP server. You get scan, plan, and manifest operations that analyze messy directories and propose reorganization schemes without touching files until you approve. The review-first workflow means Claude can examine your Downloads folder, generate a structured plan with source tracking, show you the diff, and wait for your nod before applying changes. Useful when you want an agent to help triage large file collections but need full visibility into what moves where. The same engine powers fileman's CLI and web UI, so you're working with proven organization logic rather than ad-hoc file shuffling. Part of the yard family of tools focused on structured input, structured output, and auditable operations.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
fileman
messy folders in, organized library out
What You Get • Install • How It Work • Ecosystem
fileman is a local-first file organizer. Drop a messy folder. Get a manifest, a plan, and a one-click apply. Your originals never move until you say so.
┌──────────────────────────────────────┐
│ LOCAL-FIRST ████████ 100% │
│ SOURCE-TRACEABLE ████████ 100% │
│ TYPING REQUIRED ░░░░░░░░ 0% │
│ VIBES ████████ ZERO │
│ FILLER│
└──────────────────────────────────────┘
AI-assisted file triage. Manifest-first, never destructive.
What You Get
| Surface | What |
|---|---|
fileman cli | Scan, plan, manifest. Apply only when you nod. |
fileman webui | Browse the plan. Approve, edit, or send back for another pass. |
fileman mcp | Same engine, exposed as an MCP server for any agent. |
contracts & manifest | Plans are diffable. Plans are reviewable. Plans are receipts. |
public skills | Drop into Claude/Codex/OpenClaw. Hand it a folder. Get a library. |
[!IMPORTANT] Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.
Install
git clone https://github.com/xiaojiou176-open/fileman.git
cd fileman
# follow the per-stack quickstart in INSTALL.md or docs/
Three commands. No curl | sh. No login. Read what you run.
Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap fileman for me." Agent fix own brain. Long version: docs/.
How It Work
The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.
| Layer | What |
|---|---|
chore: scaffold | License, governance, hygiene gates, CI scaffolding. |
feat(core) | The primary engine. The reason fileman exists. |
feat(modules) | Packages, adapters, services, plugins. The second floor. |
feat(contracts) | Schemas, configs, public boundaries. Other code talks here. |
test: | Receipts. Everything in this layer must run. |
feat(ops) | Scripts, infra, CI helpers, build glue. |
docs: | Public docs surface. The pretty face. |
git log reads like a building floor plan. Look once, know the whole shape.
Ecosystem
fileman lives in the yard family: seven yards. one philosophy: structured input, structured output, structured proof.
| Repo | What |
|---|---|
| switchyard | model & agent runtime switch board |
| browserclickyard | your AI clicks, your browser obeys |
| noteyard | your Apple Notes never really die |
| dealyard | let prices fight, you sit and watch |
| docyard | docs site in, markdown out, no scraping by hand |
| fileman (you here) | messy folders in, organized library out |
| proofyard | every claim ships with its receipt |
Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.
Star This Repo
If fileman saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
Also by Yifeng[Terry] Yu
- switchyard — model & agent runtime switch board
- browserclickyard — your AI clicks, your browser obeys
- BeamMe — beam your agent config to any planet
- BrewMe — wake up, news already brewed
- OpenVibeCoding — AI codes overnight, you ship in the morning
License
MIT — small print, big freedom.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →