Plugin Ops Index

Start Here

Navigation Map

• Triage playbook (failure diagnosis and report artifacts):
  • docs/plugin-triage-playbook.md
• Performance troubleshooting (gates, baseline compare, update policy):
  • docs/plugin-perf-troubleshooting.md
• Perf/usability gates and thresholds:
  • docs/plugin-performance-usability-gates.md
• Baseline artifacts and refresh commands:
  • docs/perf-baselines/README.md
• Game day scenarios:
  • docs/plugin-game-day.md

If-Then Quick Guide

• If plugin not found in list:
  • Verify plugin id and search roots, then rerun bmux plugin list --json.
• If doctor reports issues:
  • Fix error findings first; in strict mode warnings are treated as failures.
• If rebuild selector fails:
  • Use bmux plugin rebuild --list and select by id, short name, or crate name.
• If run fails with not-found command:
  • Use bmux plugin run <plugin-id> --help to inspect known commands.
• If run fails with policy denial:
  • Verify policy provider state and authorized principal.
• If perf compare reports WARN:
  • Re-run with warmup/iterations and compare startup vs steady-state before refreshing baselines.

High-Value Command Recipes