Session Manager plugins
WezTerm (Session Manager provider)
WezTerm for VibeControls
WezTerm + ttyd session provider — GPU-accelerated multiplexer in the browser.
$
vibe plugin install @vibecontrols/vibe-plugin-session-wezterm
About this plugin
WezTerm + ttyd session provider plugin for VibeControls Agent.
Cross-platform alternative to the tmux session plugin — works on Windows, macOS, and Linux.
Installation
vibe plugin install @vibecontrols/vibe-plugin-session-wezterm
Or install globally alongside the agent:
npm install -g @vibecontrols/vibe-plugin-session-wezterm
Features
- WezTerm Sessions -- Create, manage, and destroy WezTerm terminal sessions via workspaces
- Cross-Platform -- Works on Windows, macOS, and Linux (unlike tmux which is Unix-only)
- ttyd Integration -- Web terminal access via ttyd (auto-started per session)
- Headless Operation -- Uses
wezterm-mux-serverfor headless session management - Session Lifecycle -- Full lifecycle management with health checks
- Command Execution -- Run commands in existing WezTerm sessions
- Terminal Capture -- Capture terminal output from running sessions
- Port Management -- Automatic free port allocation for ttyd instances
Provider Interface
This plugin registers a session provider with the following capabilities:
| Method | Description |
|---|---|
create(config) | Create a new WezTerm session with optional ttyd terminal |
get(id) | Get session info by ID |
list() | List all managed sessions |
terminate(id) | Kill a WezTerm session and its ttyd process |
execute(id, command) | Send a command to a WezTerm session |
capture(id) | Capture current terminal output |
startTerminal(id) | Start a ttyd web terminal for a session |
stopTerminal(id) | Stop the ttyd process for a session |
healthCheck() | Check WezTerm and ttyd health |
getSystemSessions() | List all system WezTerm workspaces |
getSystemTerminals() | List all running ttyd processes |
Requirements
- VibeControls Agent >= 2.0.0
- WezTerm installed on the host system (with
weztermCLI in PATH) - ttyd installed on the host system (optional, for web terminals)
- Bun runtime >= 1.3.0
Use it in 30 seconds
- Make sure the agent is running:
vibe start - Install the meta first:
vibe plugin install @vibecontrols/vibe-plugin-session-manager - Install this plugin:
vibe plugin install @vibecontrols/vibe-plugin-session-wezterm - List installed plugins:
vibe plugin list