Two commands: add the marketplace, then install the plugin. Copy and paste into Claude Code — both lines at once. This registers the PluginOS MCP server and the built-in skill that teaches Claude to use it.
-
-
Claude chat
-
For Claude Desktop without Claude Code. Add PluginOS as an MCP server, then paste the usage rules into a Claude Project's custom instructions so Claude follows them in every message.
+
+
+
Claude Code (CLI)
+
For terminal users. Two commands — paste both at once into Claude Code to register the MCP server and skill.
-
-
+
diff --git a/packages/mcp-server/dxt/icon.png b/packages/mcp-server/dxt/icon.png
new file mode 100644
index 0000000..9999291
Binary files /dev/null and b/packages/mcp-server/dxt/icon.png differ
diff --git a/packages/mcp-server/dxt/manifest.json b/packages/mcp-server/dxt/manifest.json
new file mode 100644
index 0000000..b8c3a49
--- /dev/null
+++ b/packages/mcp-server/dxt/manifest.json
@@ -0,0 +1,33 @@
+{
+ "dxt_version": "0.1",
+ "name": "pluginos",
+ "display_name": "PluginOS",
+ "version": "0.4.0",
+ "description": "Agent-native Figma operations — run 28 Figma operations from Claude Desktop at ~230 tokens per call.",
+ "long_description": "PluginOS bridges Claude Desktop with Figma through a local MCP server and a companion Figma plugin. After installing this extension, open the PluginOS Bridge plugin inside Figma and Claude Desktop will be able to read selections, run audits, apply variables, and execute design operations on your behalf.",
+ "author": {
+ "name": "Dimitrios Arapis",
+ "url": "https://github.com/LSDimi/pluginos"
+ },
+ "homepage": "https://github.com/LSDimi/pluginos",
+ "documentation": "https://github.com/LSDimi/pluginos#readme",
+ "support": "https://github.com/LSDimi/pluginos/issues",
+ "icon": "icon.png",
+ "license": "MIT",
+ "keywords": ["figma", "design", "mcp"],
+ "server": {
+ "type": "node",
+ "entry_point": "npx",
+ "mcp_config": {
+ "command": "npx",
+ "args": ["-y", "pluginos@0.4.0"]
+ }
+ },
+ "compatibility": {
+ "claude_desktop": ">=0.10.0",
+ "platforms": ["darwin", "win32", "linux"],
+ "runtimes": {
+ "node": ">=18"
+ }
+ }
+}
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index 066941e..c68d349 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -13,10 +13,11 @@
],
"scripts": {
"build": "tsup && cp ../bridge-plugin/dist/ui.html dist/ui.html",
+ "build:dxt": "node scripts/build-dxt.mjs",
"dev": "tsx watch src/index.ts",
"test": "vitest run",
"test:coverage": "vitest run --coverage",
- "prepublishOnly": "npm run build",
+ "prepublishOnly": "npm run build && npm run build:dxt",
"postversion": "node ../../scripts/bump-lockstep.cjs",
"release:patch": "npm version patch && npm publish --access public",
"release:minor": "npm version minor && npm publish --access public"
@@ -50,8 +51,10 @@
},
"devDependencies": {
"@pluginos/shared": "*",
+ "@types/adm-zip": "^0.5.8",
"@types/ws": "^8.5.0",
"@vitest/coverage-v8": "^2.1.9",
+ "adm-zip": "^0.5.17",
"tsup": "^8.5.1",
"tsx": "^4.19.0",
"typescript": "^5.5.0",
diff --git a/packages/mcp-server/scripts/build-dxt.mjs b/packages/mcp-server/scripts/build-dxt.mjs
new file mode 100644
index 0000000..c530639
--- /dev/null
+++ b/packages/mcp-server/scripts/build-dxt.mjs
@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { readFileSync, mkdirSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import AdmZip from "adm-zip";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(here, "..");
+const dxtDir = join(pkgRoot, "dxt");
+const distDir = join(pkgRoot, "dist");
+const outFile = join(distDir, "pluginos.dxt");
+
+const manifestPath = join(dxtDir, "manifest.json");
+const iconPath = join(dxtDir, "icon.png");
+
+if (!existsSync(manifestPath)) {
+ console.error(`[build-dxt] missing ${manifestPath}`);
+ process.exit(1);
+}
+
+const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
+
+if (manifest.version !== pkg.version) {
+ console.error(
+ `[build-dxt] version mismatch: manifest=${manifest.version} package=${pkg.version}`
+ );
+ process.exit(1);
+}
+
+if (Array.isArray(manifest?.server?.mcp_config?.args)) {
+ const versioned = manifest.server.mcp_config.args.find((a) => /^pluginos@/.test(a));
+ if (versioned && versioned !== `pluginos@${pkg.version}`) {
+ console.error(
+ `[build-dxt] manifest mcp_config args pin ${versioned} but package is ${pkg.version}`
+ );
+ process.exit(1);
+ }
+}
+
+mkdirSync(distDir, { recursive: true });
+
+const zip = new AdmZip();
+zip.addLocalFile(manifestPath);
+if (existsSync(iconPath)) zip.addLocalFile(iconPath);
+zip.writeZip(outFile);
+
+console.log(`[build-dxt] wrote ${outFile}`);
diff --git a/packages/mcp-server/src/__tests__/build-dxt.test.ts b/packages/mcp-server/src/__tests__/build-dxt.test.ts
new file mode 100644
index 0000000..3fe2394
--- /dev/null
+++ b/packages/mcp-server/src/__tests__/build-dxt.test.ts
@@ -0,0 +1,36 @@
+import { describe, it, expect, beforeAll } from "vitest";
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import AdmZip from "adm-zip";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(here, "..", "..");
+const outFile = join(pkgRoot, "dist", "pluginos.dxt");
+
+describe("build:dxt", () => {
+ beforeAll(() => {
+ execSync("node scripts/build-dxt.mjs", { cwd: pkgRoot, stdio: "inherit" });
+ });
+
+ it("produces a pluginos.dxt file", () => {
+ expect(existsSync(outFile)).toBe(true);
+ });
+
+ it("includes manifest.json with the package version", () => {
+ const zip = new AdmZip(outFile);
+ const entry = zip.getEntry("manifest.json");
+ expect(entry).not.toBeNull();
+ const manifest = JSON.parse(entry!.getData().toString("utf8"));
+ const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
+ expect(manifest.version).toBe(pkg.version);
+ });
+
+ it("declares pluginos@
as the mcp command", () => {
+ const zip = new AdmZip(outFile);
+ const manifest = JSON.parse(zip.getEntry("manifest.json")!.getData().toString("utf8"));
+ const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
+ expect(manifest.server.mcp_config.args).toContain(`pluginos@${pkg.version}`);
+ });
+});
diff --git a/scripts/bump-lockstep.cjs b/scripts/bump-lockstep.cjs
index 884b977..ee5b273 100644
--- a/scripts/bump-lockstep.cjs
+++ b/scripts/bump-lockstep.cjs
@@ -1,8 +1,10 @@
#!/usr/bin/env node
/**
* Postversion hook for packages/mcp-server. When `npm version` bumps the
- * MCP server, propagate the same version string to the four peer manifests
- * so the version-lockstep check stays green.
+ * MCP server, propagate the same version string to every file that pins the
+ * pluginos version: peer package.json manifests, the DXT manifest (both the
+ * top-level `version` and its `server.mcp_config.args` pin), and the
+ * hardcoded npx args inside the Figma plugin's UI sources.
*/
const fs = require("node:fs");
const path = require("node:path");
@@ -10,17 +12,48 @@ const path = require("node:path");
const repoRoot = path.resolve(__dirname, "..");
const newVersion = require(path.join(repoRoot, "packages/mcp-server/package.json")).version;
-const targets = [
+// Peer manifests: set top-level version field.
+const packageTargets = [
"packages/claude-plugin/package.json",
"packages/claude-plugin/.claude-plugin/plugin.json",
"packages/shared/package.json",
"packages/bridge-plugin/package.json",
];
-for (const rel of targets) {
+for (const rel of packageTargets) {
const abs = path.join(repoRoot, rel);
const j = JSON.parse(fs.readFileSync(abs, "utf8"));
j.version = newVersion;
fs.writeFileSync(abs, JSON.stringify(j, null, 2) + "\n");
console.log(`Bumped ${rel} → ${newVersion}`);
}
+
+// DXT manifest: bump both `version` and the version pinned in mcp_config.args.
+const dxtManifestRel = "packages/mcp-server/dxt/manifest.json";
+const dxtAbs = path.join(repoRoot, dxtManifestRel);
+const dxt = JSON.parse(fs.readFileSync(dxtAbs, "utf8"));
+dxt.version = newVersion;
+if (Array.isArray(dxt?.server?.mcp_config?.args)) {
+ dxt.server.mcp_config.args = dxt.server.mcp_config.args.map((a) =>
+ /^pluginos@/.test(a) ? `pluginos@${newVersion}` : a
+ );
+}
+fs.writeFileSync(dxtAbs, JSON.stringify(dxt, null, 2) + "\n");
+console.log(`Bumped ${dxtManifestRel} → ${newVersion}`);
+
+// Sources that hardcode `pluginos@` in copy-paste MCP config snippets.
+// These use a regex swap so formatting is preserved.
+const sourceTargets = [
+ "packages/bridge-plugin/src/ui-entry.ts",
+ "packages/bridge-plugin/src/bootloader.html",
+];
+
+for (const rel of sourceTargets) {
+ const abs = path.join(repoRoot, rel);
+ const before = fs.readFileSync(abs, "utf8");
+ const after = before.replace(/pluginos@\d+\.\d+\.\d+/g, `pluginos@${newVersion}`);
+ if (after !== before) {
+ fs.writeFileSync(abs, after);
+ console.log(`Bumped ${rel} → pluginos@${newVersion}`);
+ }
+}
diff --git a/scripts/check-version-lockstep.cjs b/scripts/check-version-lockstep.cjs
index 4a3eeab..6563354 100644
--- a/scripts/check-version-lockstep.cjs
+++ b/scripts/check-version-lockstep.cjs
@@ -30,6 +30,11 @@ const targets = [
path: "packages/claude-plugin/.claude-plugin/plugin.json",
field: "version",
},
+ {
+ label: "packages/mcp-server/dxt/manifest.json",
+ path: "packages/mcp-server/dxt/manifest.json",
+ field: "version",
+ },
];
const readings = targets.map((t) => {
@@ -52,4 +57,4 @@ if (versions.size !== 1) {
}
const [version] = readings.map((r) => r.version);
-console.log(`[check-version-lockstep] ✓ All 5 manifests share version ${version}`);
+console.log(`[check-version-lockstep] ✓ All ${readings.length} manifests share version ${version}`);