Skip to main content

Plugins

The Plugins page gives you a complete picture of the plugins installed in your project, how their skills are being used, and the health of LSP (Language Server Protocol) integrations. It also provides controls to refresh plugins and check LSP status.

Action Buttons

Two buttons in the page header:

  • Check LSP -- runs the lsp-status command to re-check which language servers are available.
  • Refresh Plugins -- runs the refresh-plugins command to reload all plugin manifests.

Both buttons show a loading state while the command is executing. Command output appears in a dismissible panel below the header.

Summary Statistics

Four stat boxes provide a quick overview:

  • Plugins -- number of installed plugins.
  • Total Skills -- aggregate skill count across all plugins.
  • Total Commands -- aggregate command count across all plugins.
  • Trigger Keywords -- number of trigger keywords registered for auto-activation.

Installed Plugins

An expandable list of every installed plugin. Each collapsed row shows:

  • Plugin name.
  • Version number (monospace).
  • A skills badge (e.g. 5 skills).
  • A commands badge (e.g. 3 cmds).

Expanded Plugin Detail

Clicking a plugin expands it to show a skill usage table for that plugin with columns:

ColumnDescription
SkillThe skill name in monospace
InvocationsTotal number of times the skill was called
SuccessSuccess count in green, with failure count in red when non-zero (e.g. 12/3)
Last UsedRelative timestamp of the most recent invocation

If no usage data exists for a plugin, a message indicates that.

Skill Usage Leaderboard

When skill usage data is available, a bar chart shows the top 20 most-invoked skills across all plugins, sorted by invocation count in descending order. Each bar is labeled with the skill name and colored green. This visualization helps you identify which skills are most actively used and which may be underutilized.

LSP Status

When LSP data is available, a dedicated section shows:

  • An overall status badge (green for ok, amber otherwise) and the last-checked date.
  • Four stat boxes: Total Languages, Checked, Binary Missing, Plugin Missing.
  • A Missing Languages list (when any are missing), with each row showing the missing type badge (binary or plugin), language name, the install command, and a diagnostic message.

LSP Warmup Status

When warmup data is available, a section shows:

  • Elapsed warmup time (in seconds) and the timestamp of the last warmup.
  • A row of badges: green for languages that warmed up successfully, red for those that failed.
  • An empty state message when no warmup data has been recorded.

LSP warmup preloads language servers so that first-use latency is reduced. Failed warmups indicate a language server that could not initialize, which may require installing the missing binary or plugin.

Launching

Run specweave dashboard to open the SpecWeave dashboard. Navigate to the Plugins page from the sidebar. Data is fetched from the /api/plugins/full endpoint which aggregates plugins, skill usage, LSP status, and warmup state in a single request.

See Also

  • Marketplace -- discover and verify new community skills
  • Config -- plugin configuration and auto-loading settings
  • Hooks -- hook events generated by plugin-registered hooks