@vibecontrols/vibe-plugin-session-wezterm
v2026.711.1
Published
WezTerm + ttyd session provider plugin for VibeControls Agent
Maintainers
Readme
@vibecontrols/vibe-plugin-session-wezterm
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-weztermOr install globally alongside the agent:
npm install -g @vibecontrols/vibe-plugin-session-weztermFeatures
- 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
About VibeControls
VibeControls is the agentic engineering mission control for AI-native teams. Vibe-plugins extend the VibeControls agent with new providers, tools, sessions, tunnels, storage backends, and security stages.
- Website: https://vibecontrols.com
- Documentation: https://docs.vibecontrols.com
- Plugin SDK: https://github.com/algoshred/vibecontrols-plugin-sdk
- All plugins: https://github.com/algoshred?q=vibe-plugin-&type=all
Credits
This plugin builds on the following upstream open-source projects. All trademarks and copyrights remain with their respective owners.
- WezTerm — https://github.com/wezterm/wezterm
License
Released under the MIT License.
Copyright (c) 2026 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited, and all its sister companies.
Maintainer: Vignesh T.V — https://github.com/tvvignesh
Note: this plugin is open source under MIT. The @vibecontrols/agent runtime that loads and orchestrates plugins is closed source and proprietary to Burdenoff Consultancy Services Pvt. Ltd. If you want a fully self-hostable agent, please open an issue or contact the maintainer.
