Plugin Release Process

Complete guide for releasing new versions of plugins in the MAG Claude Plugins marketplace.

Critical Understanding

Claude Code plugin discovery works through TWO configuration files that MUST BOTH BE UPDATED:

1. plugins/{plugin-name}/plugin.json - The plugin's own version metadata
2. .claude-plugin/marketplace.json - The marketplace catalog (what users see when browsing)

Why both?

• plugin.json - Defines the plugin itself (agents, commands, version)
• marketplace.json - The "catalog" that Claude Code reads for plugin discovery
• Users run /plugin marketplace update which reads marketplace.json
• If you only update plugin.json, users won't see the new version!