Omniscient Master Suite OMNISCIENT · 3.1
Sign in with OmniumPortalSign in

Small File Remover v1.0.0

Files & backup small-file-remover 3 actions MCP

Find files at or under (or over) a size threshold in a folder, then quarantine them to a dump folder or delete them outright - every removal previews as a dry-run first and quarantine batches can be undone.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: findremoveundo

Find small files

find

Scan a folder and list files whose size falls under a max threshold and/or over a min threshold, in KB, without changing anything.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
max_kb int optional
min_kb int optional
recursive bool optional, default false

Outputs

NameTypeNotes
scanned int
matched int
total_bytes int
files json

Remove small files

remove Destructive

Move every file at or under max_kb (KB) into a quarantine dump folder (default), or delete them outright with mode='delete'. Use --dry-run to preview; quarantine batches can be reversed with 'undo'.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
max_kb int required
recursive bool optional, default false
mode enum optional, default quarantine quarantinedelete
dest path optional, default ""

Outputs

NameTypeNotes
matched int
removed int
mode string
dest path
changes json

Undo last quarantine

undo Destructive

Restore the files from the most recent quarantine batch for a folder, using the journal Small File Remover keeps. Batches removed with mode='delete' cannot be restored.

Inputs

NameTypeRequired / defaultValues and notes
folder path required

Outputs

NameTypeNotes
restored int
changes json

Use it

Find small files

Command line

shell
python app.py --action find --params '{"folder": "D:/path/to/folder"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("small-file-remover", "find", {"folder": "D:/path/to/folder"})

Workflow node

json
{
  "id": "n0",
  "app": "small-file-remover",
  "action": "find",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Remove small files

Command line

shell
python app.py --action remove --params '{"folder": "D:/path/to/folder", "max_kb": 1}'

# preview first - destructive action, nothing is changed:
python app.py --action remove --params '{"folder": "D:/path/to/folder", "max_kb": 1}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("small-file-remover", "remove", {"folder": "D:/path/to/folder", "max_kb": 1})

# preview first:
run_action("small-file-remover", "remove", {"folder": "D:/path/to/folder", "max_kb": 1}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "small-file-remover",
  "action": "remove",
  "params": {
    "folder": "D:/path/to/folder",
    "max_kb": 1
  },
  "inputs": {}
}

Undo last quarantine

Command line

shell
python app.py --action undo --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action undo --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("small-file-remover", "undo", {"folder": "D:/path/to/folder"})

# preview first:
run_action("small-file-remover", "undo", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "small-file-remover",
  "action": "undo",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.