@vibecontrols/vibe-plugin-session-terminal

Direct ttyd session provider for the VibeControls Agent — a plain terminal with no multiplexer (no tmux / wezterm / zellij) and no persisted session.

startTerminal spawns ttyd wrapping the login shell directly, so:

• Native selection / copy-paste — there is no tmux mouse mode to intercept a drag, so click-drag selects text and copies exactly like a local terminal (iTerm2-style).
• Ephemeral — there is no daemon to reattach to; closing the terminal ends the shell. This is the "just open a terminal" mode.

The provider registers itself as session-terminal. The workspace backend maps SessionType.TERMINAL to this provider, so creating a session of type Terminal in the web UI routes here. Agents that don't have this plugin installed simply fall back to their default multiplexer.

Capabilities

| feature | supported | | ---------------------------------------------------- | ---------------------------- | | web terminal (ttyd) | ✅ | | native scrollback / clipboard | ✅ | | resize (xterm over ws) | ✅ | | programmatic input / capture (sendKeys, capture) | ❌ (use tmux/wezterm/zellij) | | split panes / tabs / mouse mode | ❌ |

Prerequisites

• ttyd (auto-installed from the official static releases on Linux/Windows; brew install ttyd on macOS).

Development

bun install
bun run sanity   # format:check, lint, type:check, build

License: MIT