@vibecontrols/vibe-plugin-session-tmux
v2026.608.2
Published
Tmux + ttyd session provider plugin for VibeControls Agent
Maintainers
Readme
@vibecontrols/vibe-plugin-session-tmux
Tmux + ttyd session provider plugin for VibeControls Agent.
Installation
vibe plugin install @vibecontrols/vibe-plugin-session-tmuxOr install globally alongside the agent:
npm install -g @vibecontrols/vibe-plugin-session-tmuxFeatures
- Tmux Sessions -- Create, manage, and destroy tmux terminal sessions
- ttyd Integration -- Web terminal access via ttyd (auto-started per session)
- Session Lifecycle -- Full lifecycle management with health checks
- Command Execution -- Run commands in existing tmux 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 tmux session with optional ttyd terminal |
| get(id) | Get session info by ID |
| list() | List all managed sessions |
| terminate(id) | Kill a tmux session and its ttyd process |
| execute(id, command) | Send a command to a tmux 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 tmux and ttyd health |
| getSystemSessions() | List all system tmux sessions |
| getSystemTerminals() | List all running ttyd processes |
Requirements
- VibeControls Agent >= 2.0.0
- tmux installed on the host system
- 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.
- tmux — https://github.com/tmux/tmux
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.
