@burdenoff/vibe-plugin-ssh

SSH connections & port forwarding plugin for VibeControls Agent.

Installation

vibe plugin install @burdenoff/vibe-plugin-ssh

Or install globally alongside the agent:

npm install -g @burdenoff/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

License

Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.