@vibecontrols/vibe-plugin-ssh

SSH connections & port forwarding plugin for VibeControls Agent.

Platform support

This plugin is POSIX-only for now (Linux, macOS, WSL). It shells out to ssh, scp, chmod, tar, and uses nohup to launch ttyd on the remote host. Native Windows support (cmd / PowerShell) is not yet implemented — the plugin self-disables on process.platform === "win32" and the CLI subcommands exit early with a "not supported on Windows yet" message. Track progress in the issue tracker.

Installation

vibe plugin install @vibecontrols/vibe-plugin-ssh

Or install globally alongside the agent:

npm install -g @vibecontrols/vibe-plugin-ssh

Then register it:

vibe plugin list  # verify it shows up

Features

• SSH Connections — Save, test, and manage SSH connection configs
• Remote Execution — Execute commands on remote servers via SSH
• Port Forwarding — Create and manage SSH port forwards (local → remote)
• Real-time Output — SSH command output streamed via Socket.IO events

API Routes

Once installed, the plugin registers these routes on the agent:

| Method | Path | Description | | ------ | ----------------------------- | --------------------------- | | GET | /api/ssh/connections | List all SSH connections | | POST | /api/ssh/connections | Create a new SSH connection | | POST | /api/ssh/execute | Execute a remote command | | POST | /api/ssh/test/:id | Test an SSH connection | | DELETE | /api/ssh/connections/:id | Delete a connection | | GET | /api/port-forward/ | List all port forwards | | POST | /api/port-forward/ | Create a port forward | | POST | /api/port-forward/:id/start | Start forwarding | | POST | /api/port-forward/:id/stop | Stop forwarding | | DELETE | /api/port-forward/:id | Delete a forward |

CLI Commands

SSH and port forward CLI commands are built into the vibe CLI:

vibe ssh list                       # List saved connections
vibe ssh add --name my-server ...   # Add a connection
vibe ssh test -i <id>               # Test connectivity
vibe ssh exec -i <id> -c "uptime"   # Run remote command

vibe forward list                   # List port forwards
vibe forward create --local 5432 --remote-host db --remote-port 5432 --server my-server
vibe forward start -i <id>          # Start forwarding
vibe forward stop -i <id>           # Stop forwarding

Requirements

• VibeControls Agent >= 1.1.0
• Node.js >= 18.0.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.

• OpenSSH — https://www.openssh.com/

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.