authoring-pluginpack-config

Authoring a pluginpack config

pluginpack compiles one portable source into each app's native plugin format. The config (pluginpack.config.ts) declares the source layout and the targets to emit.

Fastest start

npx @gleanwork/pluginpack init scaffolds a pluginpack.config.ts and an example source plugin. Then edit to taste.

Config shape

import { defineConfig } from "@gleanwork/pluginpack";

export default defineConfig({
  name: "acme-plugins",
  version: "0.1.0",
  source: {
    // Recommended: portable skills at the repo-level skills/ directory.
    skills: "skills",
    rootPlugin: { id: "core", description: "Acme portable skills." },
    // Alternatively, richer source plugins live under plugins/<id>/.
    // plugins: "plugins",
  },
  metadata: {
    description: "Acme agent plugins.",
    author: { name: "Acme" },
    owner: { name: "Acme", email: "[email protected]" },
    license: "MIT",
  },
  targets: {
    cursor: {
      outDir: ".",
      plugins: {
        acme: {
          from: ["core"],
          path: "plugins/cursor/acme",
          components: ["skills"],
        },
      },
    },
    claude: {
      outDir: ".",
      pluginRoot: "plugins/claude",
      plugins: { acme: { from: ["core"] } },
    },
    antigravity: {
      outDir: "plugins/antigravity",
      plugins: { acme: { from: ["core"] } },
    },
    copilot: {
      outDir: "plugins/copilot",
      plugins: { acme: { from: ["core"] } },
    },
    codex: {
      outDir: "plugins/codex",
      plugins: { acme: { from: ["core"] } },
    },
  },
});

• source.skills is the portable surface; source.rootPlugin.id is the source plugin name targets reference via from.
• Each emitted plugin's from lists the source plugin id(s) to include; multiple ids merge (a colliding file path is an error).
• path / pluginRoot control where a target places the emitted plugin.

Critical: avoid output collisions

claude and copilot both write .claude-plugin/marketplace.json, so they cannot share an outDir. Give them distinct roots (e.g. claude at ., copilot at plugins/copilot). pluginpack build errors on overlapping output paths.