Plugin Management

Plugins extend Studio with agents, skills, hooks, and MCP servers. Vibedata Owners manage them from Org Settings → Plugins, which has two tabs: Marketplaces and Plugins.

Marketplaces

The Marketplaces tab lists every registered plugin source. Each row shows its repository or URL, a meter for installed plugins as a proportion of its catalog, and the last catalog update.

Select a row or its chevron to open the Plugins tab filtered to that marketplace.

For an operator-managed marketplace:

• Use the row switch to include or exclude its catalog from plugin browsing and new installations. Turning it off does not uninstall plugins already installed from it.
• Open the overflow menu to Update marketplace or Remove marketplace. Updating refreshes catalog contents and does not upgrade installed plugins. Removing shows a confirmation and uninstalls the marketplace's plugins, including their Domain-specific exclusions.

Studio-managed marketplaces show Managed by Studio. They do not have an availability switch or overflow menu.

Failed operator-managed marketplaces retain recovery and removal actions. Studio-managed failures remain visible and Studio retries their registration during a later boot.

Add a marketplace

1. Select Add marketplace in the page header.
2. Enter owner/repo, owner/repo#branch, or an HTTPS marketplace.json URL.
3. Select Add.

The list is replaced by the add form while you complete this task. Use Cancel or Back to marketplaces to return without adding a source.

Upgrade installed plugins

Select Upgrade all in the Marketplaces page header to run the installed-plugin refresh operation. This upgrades installed plugins; Update marketplace only refreshes catalog metadata.

Plugins

The Plugins tab combines available and installed plugins from all marketplaces under Needs attention, Installed, and Not installed headings. Use search, the marketplace filter, and the installation-state filter to narrow the list.

Each row shows the plugin name, marketplace, number of included skills, description, revision, and number of Domains where it is enabled. Routine states use plain text or control state. Badges call attention to failed installations and work in progress.

Install or uninstall a plugin

The row switch controls installation for the organization:

• Turn on an available plugin to review the trust confirmation and install it.
• Turn off an installed plugin to review the destructive confirmation and uninstall it.
• The switch is temporarily unavailable while installation or update work is pending.

Open the row overflow menu for secondary lifecycle actions:

• A failed first installation has Retry installation and Remove failed installation.
• An installed plugin has Upgrade now and Auto-update.

Uninstall clears the plugin's Domain-specific exclusions. Existing AgentSessions keep the plugin folders supplied when the session was created; lifecycle changes apply when an AgentSession is created or recreated.

Domain plugin settings

Every usable installed plugin is enabled for every Domain by default. This also applies when a plugin is installed after the Domain is created and when a Domain is created after the plugin is installed.

To change availability for one Domain:

1. Open the Domain.
2. Select Plugins.
3. Use search and the marketplace filter to narrow the installed-plugin list when needed.
4. Turn a plugin switch off to disable it for that Domain, or on to restore the default.

The Domain stores only disabled exceptions. The organization Plugins page reports how many Domains have each plugin enabled. Domain Owners manage Domain-specific availability; Vibedata Owners manage organization installation.

Troubleshooting

A marketplace is disabled but its installed plugins still appear

This is expected. Marketplace availability controls discovery and new installation only. Use each plugin's switch to uninstall it from the organization, or use Domain settings to disable it for one Domain.

An installed plugin is not available to an agent

Confirm that the plugin is installed and enabled in the Domain's Plugins tab. Then recreate or restart the AgentSession so it resolves the latest plugin state.

A marketplace update did not upgrade a plugin

Use Upgrade now from the plugin row overflow or Upgrade all in the Marketplaces header. Marketplace update refreshes the catalog only.