Plugin Management

Plugin changes retain the individual plugin or marketplace you reviewed. A background refresh can invalidate that review even without a configuration edit. After a conflict, use Reload plugin settings or Reload marketplaces and review the action again. Marketplace removal reviews both the marketplace and its affected plugins; use Reload removal preview if that confirmation becomes stale. Vibedata does not automatically retry a changed review.

Plugins extend Vibedata 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, plain counts of installed plugins and total catalogue entries, and Last updated, the last successful catalog refresh. Before a successful refresh, it shows Not updated yet. Hover over or focus the timestamp to see the exact update time.

Select a row 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.

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

Failed operator-managed marketplaces retain recovery and removal actions. Vibedata-managed failures remain visible and Vibedata 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. Search plugins, the marketplace filter, and the installation-state filter share one toolbar.

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. Status indicators call attention to failed installations and work in progress.

Installed plugin rows show Last updated, the last successful installation or update time, or Not updated yet when no successful update is recorded. A failed refresh preserves that timestamp and shows Update failed, Last attempt, and the error while the last-known-good revision stays installed and usable. After a successful or unchanged refresh, the row returns to Installed and clears the failure details. Routine rows show their metadata beneath the name without an expanded details section.

Install or uninstall a plugin

The row switch controls installation for the organization:

• Turn on an available plugin to install it directly. There is no confirmation popup; the page header description explains that plugins can execute code, and uninstalling reverses the install.
• Turn off an installed plugin to open 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 the marketplace filter on the left and Search plugins on the right to narrow the installed-plugin list at desktop widths.
4. Turn a plugin switch off to disable it for this Domain, or on to restore the default. The change starts immediately.

While a change is in progress, that plugin's switch waits for its result; you can change other plugins at the same time. If the change fails or the saved availability changed elsewhere, the switch returns to its saved position and the row shows the error. Review the row and try again.

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.

When no usable plugin is installed yet, the Plugins tab explains where plugins are installed instead of showing the search and marketplace filters.

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.