UI Hello for VibeControls
Minimal example UI plugin — copy as a starting point for new iframe-mounted plugin UIs.
vibe plugin install @vibecontrols/vibe-plugin-ui-hello
About this plugin
Sample UI plugin used by the VibeControls doctor's Playwright E2E spec.
Contributes to both vibe.detailTab and agent.detailTab from the
same package so the cross-mount-point story is exercised end-to-end.
Layout
src/
index.ts # Plugin manifest (VibePluginFactory)
ui-dist/
index.html # Iframe content (hand-rolled v1 envelope)
The static UI is dependency-free on purpose — when the doctor test fails, the iframe payload is easy to read.
Build
bun install
bun run build # bundles src/index.ts → dist/index.js
The ui-dist/ directory is shipped as-is alongside dist/ and served
by the agent at /ui/vibe-plugin-ui-hello.
Install on a running agent
vibe plugin install @vibecontrols/vibe-plugin-ui-hello
Then open https://vibecontrols.local.burdenoff.com/vibecontrols/vibes/<id>
with the vibes.tabs.iframe-host feature flag enabled — the "Hello"
tab appears in the strip.
Use it in 30 seconds
- Make sure the agent is running:
vibe start - Install this plugin:
vibe plugin install @vibecontrols/vibe-plugin-ui-hello - List installed plugins:
vibe plugin list