plugin-marketplace-wizard
v0.1.9
Published
Visual editor for building and managing agent plugin marketplaces
Readme
A CLI tool with a visual editor for creating, managing, and exporting agent plugin marketplace packages for Cursor, Claude Code, GitHub Copilot, and Codex. Discover MCP servers and skills from your local environment, browse official registries, and assemble plugins using an interactive drag-and-drop canvas.
Quick Start
npx create-plugin-marketplace-wizard my-marketplace
cd my-marketplace
npm startThat's it. A browser window opens with the visual editor pointed at your new marketplace.
Adding to an existing project?
npm install plugin-marketplace-wizard --save-dev npx pmw init npm start
What You Get
Plugin Marketplace Wizard gives you a drag-and-drop canvas for assembling plugin packages. It scans your local environment for MCP servers and skills, lets you search official registries, and writes valid marketplace manifests on every change.
The output is a directory you can publish or distribute:
my-marketplace/
├── .cursor-plugin/
│ └── marketplace.json
├── .claude-plugin/
│ └── marketplace.json
├── .github/
│ └── plugin/
│ └── marketplace.json
├── .agents/
│ └── plugins/
│ └── marketplace.json
└── plugins/
└── <plugin-slug>/
├── .cursor-plugin/plugin.json
├── .claude-plugin/plugin.json
├── .codex-plugin/plugin.json
├── plugin.json ← GitHub Copilot
├── .mcp.json
├── skills/
│ └── <skill-name>/
│ └── SKILL.md
└── agents/
└── <agent-name>.mdFeatures
| | |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Visual Canvas | Drag-and-drop interface built on ReactFlow for assembling and organizing plugins |
| Local Discovery | Scans Cursor, Claude, VS Code, Windsurf, Zed, Cline, Roo, and other IDE configs for MCP servers and skills |
| Official Registries | Search the MCP Registry and Skills.sh for community-published servers and skills |
| Custom Registries | Connect any registry that implements the MCP Server Registry API |
| Real-time Auto-save | Persists changes directly to your marketplace directory as you edit |
| Inline Validation | Visual indicators for configuration issues on the canvas |
| CI Validation | Run pmw test in your pipeline to catch errors before deploy |
| Category Grouping | Plugins with the same category are automatically grouped into labeled regions |
| Plugin Search | Press Cmd+K to find and focus any plugin on the canvas |
| Skill File Import | Drop .zip or .skill files onto plugin cards or the canvas |
| Hot Reload | Watches for external file changes and syncs automatically |
| Undo / Redo | Full history with Cmd+Z / Cmd+Shift+Z |
CLI Reference
After installing, the pmw command is available in your npm scripts:
{
"scripts": {
"start": "pmw start",
"test": "pmw test"
}
}pmw start [dir]
Start the visual editor. Opens a browser-based UI for managing your marketplace.
pmw start # Current directory
pmw start ./my-market # Specific directory
pmw start -p 4000 # Custom portpmw test [dir]
Validate all marketplace files. Designed for CI — exits non-zero on failure.
pmw test PMW v0.1.4
/Users/you/my-marketplace
PASS marketplace structure
PASS marketplace manifest
PASS plugin structure
PASS plugin manifests
PASS mcp configurations
PASS skill files
Tests: 6 passed, 6 total
Time: 0.02spmw init [dir]
Scaffold a new marketplace. Creates .cursor-plugin/, .claude-plugin/, .agents/plugins/, and plugins/ directories with initial manifests.
pmw init
pmw init ./new-marketplacepmw -v / pmw -h
Print version or show help.
Deployment Guides
Once your marketplace is ready, follow the guide for your target platform:
- Adding your marketplace to Cursor
- Adding your marketplace to Claude Code (CLI)
- Adding your marketplace to Claude (Organization)
- Adding your marketplace to GitHub Copilot CLI
- Adding your marketplace to Codex
TypeScript API
All types and validation utilities are exported from the package:
import type {
PluginData,
McpServer,
Skill,
AgentData,
MarketplaceManifest,
MarketplaceSettings,
ValidationIssue,
} from "plugin-marketplace-wizard"
import {
validatePluginData,
validateMarketplaceManifest,
validateMcpServer,
validateSkill,
} from "plugin-marketplace-wizard"Tech Stack
| Layer | Technology | | ------------- | ------------------------------------------------ | | Framework | Next.js 16 with Turbopack | | UI | React 19 | | Canvas | @xyflow/react | | State | Zustand | | Styling | Tailwind CSS 4 | | Components | shadcn/ui | | Icons | Lucide React | | Notifications | Sonner |
Contributing
Contributions are welcome. Here's how to get started:
git clone https://github.com/webrix-ai/plugin-marketplace-wizard.git
cd plugin-marketplace-wizard
npm install
npm run devThis starts the Next.js dev server directly. To test via the CLI path instead:
node bin/cli.mjs startPlease read our Contributing Guide to get started.
For security issues, see SECURITY.md.
Before submitting a PR:
- Run
npm run lintto check for lint errors - Run
npm testto validate the sample marketplace - Keep commits focused — one logical change per PR
