Skip to main content

Agent Plugins (built-in)

The agent ships with a set of plugins published under @vibecontrols/vibe-plugin-*. Most are pluggable providers — replace them with your own if you want different behavior.

Sessions

PluginProvides
@vibecontrols/vibe-plugin-session-tmuxTMUX session provider + ttyd web terminal
@vibecontrols/vibe-plugin-session-weztermWezTerm session provider
@vibecontrols/vibe-plugin-session-zellijZellij session provider
@vibecontrols/vibe-plugin-tool-sshSSH session provider

Each implements the agent's SessionProvider interface (23 methods: create, terminate, getInfo, list, sendCommand, sendKeys, etc., plus healthCheck).

Tunnels

PluginProvides
@vibecontrols/vibe-plugin-tunnel-cloudflareCloudflare quick tunnels (cloudflared tunnel --url <port> subprocess; *.trycloudflare.com URLs)
@vibecontrols/vibe-plugin-tunnel-vibetunnelsfrp-based tunnels (frpc subprocess; requires your own frps)

Both implement TunnelProvider. The agent's registry resolves which provider to use per tunnel request.

AI

PluginProvides
@vibecontrols/vibe-plugin-aiAI assistant orchestration: tool detection, prompt templates, context management, AI sessions, queueing. Exposes REST routes at /api/ai/prompts/*, /api/ai/tools.

AI provider sub-plugins (pluggable LLM backends):

  • vibe-plugin-ai-claude — Anthropic Claude
  • vibe-plugin-ai-openai — OpenAI
  • vibe-plugin-ai-openrouter — OpenRouter (multi-provider gateway)

Specialized

PluginProvides
@vibecontrols/vibe-plugin-planPlan capture for AI sessions — stores generated plans, integrates with the Plannotator portal
@vibecontrols/vibe-plugin-agent-backupPeriodic state backup to a configured backend

How they're loaded

The agent reads its loaded-plugin list from ~/.boff/vibecontrols/agents/<id>/config.json. The default install enables session-tmux + tunnel-cloudflare + AI + plan. Add more by installing the npm package and registering it.

Building your own

Building a custom plugin