Enconvo 外掛程式 文件

Mole Disk Cleaner

安裝

See how full your Mac's disk is and free space with the Mole CLI: a Disk Cleaner you open from the Chat Window, a chat's side panel or a SmartBar command, a searchable Space to Free list in the SmartBar, and a PopBar button that measures a selected folder.

簡介

See how full your Mac's disk is and free space with Mole. A sample of a third-party Enconvo plugin with UI: one MCP server in plain Node.js, no dependencies, two MCP App views and a list Mini App. Other MCP hosts (Codex, Claude Code) get the same tools and views.

Needs Mole: brew install mole.

Where it shows up in Enconvo

Installing the plugin adds its entry points (ADR-0126); there is nothing to place by hand.

ToolDeclaresShows up as
cleanup_preview_meta.ui.resourceUri ui://mole/cleaner.html, _meta["openai/ui"].entrypoints global and threadDisk Cleaner in the Chat Window sidebar, a tab in a chat's side panel, and a SmartBar command (search and @) that opens the view
analyze_path_meta.ui.resourceUri ui://mole/folder.html, _meta["com.enconvo/popbar"] { "input": "selection" }A PopBar button that measures the selected file or folder path and shows Folder Size
cleanup_list_meta["com.enconvo/list"] { "search": "filter" }Space to Free, a SmartBar list Mini App (ADR-0128): the startup disk's free space, then what Mole can clean by kind, biggest first. Typing filters it; ↵ scans again and ⌘↵ cleans after a confirmation
disk_space, cleanup_preview_meta["com.enconvo/widget"] with Island slots onlyDynamic Island widgets: used space ring, what can be cleaned

A PopBar tool is called with { "selection": "<selected text>" }; a global entrypoint with {}. A PopBar button is added once: one the user removes stays removed.

clean_run is app-only (_meta.ui.visibility: ["app"]): the model never sees it, and a host that doesn't name the MCP Apps extension (io.modelcontextprotocol/ui) at initialize, and so might show it to its model anyway, gets neither the tool nor a way to call it. cleanup_scan only runs a dry run, so any model may start one. clean_run is destructiveHint, needs the previewId of the preview the user looked at, and its Island widget action carries a confirm line, so Enconvo asks first. The Disk Cleaner view asks before it cleans.

mo clean deletes for good (Mole's trash mode covers only uninstalls), empties the Trash, and skips what needs sudo because it runs without a terminal. Clean is offered, and clean_run accepted, only for a preview less than a day old; an older one is scanned again first. Sizes are in base 10 (1 GB = 1,000,000,000 bytes), as Mole and Finder show them. Stopping a run stops Mole's whole process group.

A scan reads other apps' caches in ~/Library/Containers, so the first one makes macOS ask whether Enconvo may access data from other apps. That first scan starts only from Scan (or a model's cleanup_scan); after it, the widget scans again by itself when its preview is a day old or a cleanup removed it. The scan waits for the answer; one that prints nothing for 3 minutes stops and the widget asks to answer the prompt and scan again.

Files
FileWhat it is
plugin.jsonPortable manifest (Agent Plugins)
.codex-plugin/plugin.json, .claude-plugin/plugin.jsonCodex and Claude Code manifests
mcp.json, .mcp.jsonThe server, for portable hosts and for Claude Code. Change both together
mcp/server.mjsThe MCP server
mcp/cleaner.htmlThe Disk Cleaner view
mcp/folder.htmlThe Folder Size view
test/server.test.mjsTests against a fake mo; they never clean anything
Try it
node --test test/server.test.mjs               # tests, with a fake mo
enconvo plugin validate                         # checks the package
enconvo plugin install .                        # installs it in Enconvo (Enconvo has to be running)

MOLE_BIN points the server at another mo; MOLE_WIDGET_DRY_RUN=1 makes a cleanup run pass --dry-run. enconvo is the CLI Enconvo installs in ~/.config/enconvo/bin.

Publish
enconvo plugin publish                          # the Enconvo plugin store, with your Enconvo account

Raise version in the three manifests for every release.

MCP 伺服器1

資訊

開發者
ysnows
類別
效率
版本
0.3.2
更新於
2026年10月24日
安裝次數
15

外掛商店裡的每個外掛上架前都經過 Enconvo 審核。

版本紀錄