Plugins

Plugins Module: Step-by-Step Tutorial

Manage plugin lifecycle from discovery to runbook checks and runtime hooks.

Step 1: List current plugins

mosaic --project-state plugins list
mosaic --project-state plugins list --source all

Step 2: Check plugin health baseline

mosaic --project-state plugins doctor
mosaic --project-state plugins check

Step 3: Install a plugin from local path

mosaic --project-state plugins install --path ./plugins/example-plugin
# if you need overwrite
mosaic --project-state plugins install --path ./plugins/example-plugin --force

Use your actual plugin directory path in place of ./plugins/example-plugin.

Step 4: Inspect and validate plugin metadata

mosaic --project-state plugins info <plugin_id>
mosaic --project-state plugins check <plugin_id>

Step 5: Enable/disable plugin safely

mosaic --project-state plugins enable <plugin_id>
mosaic --project-state plugins disable <plugin_id>

Step 6: Execute plugin hooks

mosaic --project-state plugins run <plugin_id>
mosaic --project-state plugins run <plugin_id> --hook doctor
mosaic --project-state plugins run <plugin_id> --hook run --arg key=value --timeout-ms 15000

Step 7: Remove deprecated plugin

mosaic --project-state plugins remove <plugin_id>
mosaic --project-state plugins list

Step 8: JSON mode for automation

mosaic --project-state --json plugins list
mosaic --project-state --json plugins check <plugin_id>