SSH for VibeControls

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