plugin
npx dimo plugin packs a deterministic .vxp and installs, lists, updates, uninstalls, and publishes packages on the current Host and the official marketplace. Templates and harness tests use dimo-plugin (source at packages/plugin-cli). Bind a Host with dimo plugin run server, then dimo plugin run dev from the plugin directory. See Development workflow.
When desktop or npx dimo serve is running, the command finds the local Host token. If no Host is up, add writes snapshots to ~/.dimo/imports/ and linked directories to ~/.dimo/imports/links.jsonl; the next launch imports them. Default URL is http://127.0.0.1:17891; override with DIMO_URL / DIMO_TOKEN. list, update, remove, gc-runtimes, and test --host need a running Host.
npx dimo plugin pack
npx dimo plugin pack
npx dimo plugin pack .
npx dimo plugin pack ./my-plugin
npx dimo plugin pack ./my-plugin --output ./dist/office.vxpThe first argument is the plugin root; it defaults to the current directory. That directory must contain .dimo-plugin/plugin.json, README.md, and the rest of the layout in Package layout.
Order of work: full validation first (summary, schema, content index, integration refs). Failures print each code: message line and exit. On success a .vxp is written and stdout prints two lines:
/absolute/path/dist/<plugin-id>-<version>.vxp
sha256:<packageDigest>--output sets the result file. The default is dist/<plugin-id>-<version>.vxp inside the plugin directory.
The same source packed twice with npx dimo plugin pack should yield the same sha256. Published npx packages embed plugin-cli under plugin-cli/. A missing directory raises Dimo Plugin CLI is unavailable; reinstall or upgrade the dimo npm package.
npx dimo plugin add
npx dimo plugin add --web <git-or-url[#ref]> [--plugin ID] [--yes]
npx dimo plugin add --profile <file.vxp|archive> [--plugin ID] [--yes]
npx dimo plugin add --dev <dir> [--yes] [--detach]--web accepts a marketplace page, Git repository, GitHub Release, or archive URL. #tag, #branch, and #commit pin the tree. A GitHub Release that ships a .vxp verifies SHA-256 when a digest or sibling .sha256 is present. --profile installs a local archive. --dev links a development directory: it builds first, then the Host watches the digest; without --detach it prints Worker stderr; --detach returns after linking. HMR is started by dimo plugin run dev. Use only one of the three modes. Without a flag, the command infers directory, file, or URL.
Add --plugin when the archive contains more than one package. Use --yes when stdin is not a TTY.
User path: Install a Plugin from the marketplace. Linked development: Development workflow.
npx dimo plugin list / update / remove
npx dimo plugin list [--json]
npx dimo plugin update <id> [--ref tag] [--yes]
npx dimo plugin remove <id> [--yes] [--delete-data]
npx dimo plugin gc-runtimeslist is the Installed catalog, including source and lock. update fetches another snapshot from the locked origin; linked development plugins edit the source directory instead. remove uninstalls an installed package and keeps config by default; --delete-data deletes the Host-managed snapshot and config, and reclaims unreferenced Runtimes. A linked development directory is not deleted. gc-runtimes deletes Host-managed Runtimes that no plugin references.
Unknown subcommands such as npx dimo plugin init raise Unknown plugin command. Init belongs to dimo-plugin.
npx dimo plugin publish
npx dimo plugin publish [dir|file.vxp]
npx dimo plugin publish --web <github-owner/repo[#tag]>Submit a packed package or a GitHub repository into the official marketplace review queue. Register a marketplace account first. The GitHub owner must match the marketplace username.
Credentials come from --owner / --password, or DIMO_MARKET_OWNER / DIMO_MARKET_PASSWORD. The default catalog is https://dimo-ai.com; override with DIMO_MARKETPLACE_URL. Packed uploads can pass --show-tree to show the package tree; GitHub listings show it by default.
After review, one owner/plugin-name card keeps version history. A listed GitHub repository adds a version when a new tag is pushed and keeps older versions. Hosts that installed from that card or repository show an update affordance.
npx dimo plugin test --host
npx dimo plugin test --host
npx dimo plugin test --host ./my-pluginRuns link, enable, chrome / structure contribution appear-and-withdraw, Skill reload, and uninstall against a running Host. Looks up a local Host token when DIMO_TOKEN is unset.
npx dimo plugin --help / npx dimo help plugin
npx dimo plugin --help
npx dimo help pluginPrints usage for pack / add / publish / list / update / remove / gc-runtimes / test --host / run and skips the Host.