Bulk add, remove, or swap file extensions across a whole folder. Every rename can be previewed as a dry-run first and undone afterwards.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
remove_extensionadd_extensionchange_extensionundo
remove_extension
Destructive
Strip the extension from every matching file in a folder. Leave 'ext' empty to strip whatever extension each file has.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
ext |
string |
optional, default ""
|
| Name | Type | Notes |
|---|---|---|
renamed |
int | |
changes |
json |
add_extension
Destructive
Append an extension to every file in a folder that doesn't already have it.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
ext |
string | required |
| Name | Type | Notes |
|---|---|---|
renamed |
int | |
changes |
json |
change_extension
Destructive
Swap one extension for another across every matching file in a folder.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
from_ext |
string | required | |
to_ext |
string | required |
| Name | Type | Notes |
|---|---|---|
renamed |
int | |
changes |
json |
undo
Destructive
Reverse the most recent extension change made in a folder, using the journal this app keeps.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required |
| Name | Type | Notes |
|---|---|---|
restored |
int |
python app.py --action remove_extension --params '{"folder": "D:/path/to/folder"}'
# preview first - destructive action, nothing is changed:
python app.py --action remove_extension --params '{"folder": "D:/path/to/folder"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("extension-remover", "remove_extension", {"folder": "D:/path/to/folder"})
# preview first:
run_action("extension-remover", "remove_extension", {"folder": "D:/path/to/folder"}, dry_run=true){
"id": "n0",
"app": "extension-remover",
"action": "remove_extension",
"params": {
"folder": "D:/path/to/folder"
},
"inputs": {}
}python app.py --action add_extension --params '{"folder": "D:/path/to/folder", "ext": "<ext>"}'
# preview first - destructive action, nothing is changed:
python app.py --action add_extension --params '{"folder": "D:/path/to/folder", "ext": "<ext>"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("extension-remover", "add_extension", {"folder": "D:/path/to/folder", "ext": "<ext>"})
# preview first:
run_action("extension-remover", "add_extension", {"folder": "D:/path/to/folder", "ext": "<ext>"}, dry_run=true){
"id": "n0",
"app": "extension-remover",
"action": "add_extension",
"params": {
"folder": "D:/path/to/folder",
"ext": "<ext>"
},
"inputs": {}
}python app.py --action change_extension --params '{"folder": "D:/path/to/folder", "from_ext": "<from_ext>", "to_ext": "<to_ext>"}'
# preview first - destructive action, nothing is changed:
python app.py --action change_extension --params '{"folder": "D:/path/to/folder", "from_ext": "<from_ext>", "to_ext": "<to_ext>"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("extension-remover", "change_extension", {"folder": "D:/path/to/folder", "from_ext": "<from_ext>", "to_ext": "<to_ext>"})
# preview first:
run_action("extension-remover", "change_extension", {"folder": "D:/path/to/folder", "from_ext": "<from_ext>", "to_ext": "<to_ext>"}, dry_run=true){
"id": "n0",
"app": "extension-remover",
"action": "change_extension",
"params": {
"folder": "D:/path/to/folder",
"from_ext": "<from_ext>",
"to_ext": "<to_ext>"
},
"inputs": {}
}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-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("extension-remover", "undo", {"folder": "D:/path/to/folder"})
# preview first:
run_action("extension-remover", "undo", {"folder": "D:/path/to/folder"}, dry_run=true){
"id": "n0",
"app": "extension-remover",
"action": "undo",
"params": {
"folder": "D:/path/to/folder"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.