@mcowger/opencode-sshmaster

An OpenCode plugin that manages SSH master connections and port forwarding directly from the TUI sidebar.

Features

• Automatic SSH master connection with ControlMaster for persistent tunnels
• Add/remove port forwards interactively via dialog
• Health monitoring with auto-reconnect
• Keyboard shortcuts for all actions via the command palette
• Windows unsupported (shown as a notice in the sidebar)

Install

Add the plugin to your opencode.json:

{
  "plugin": [
    ["@mcowger/opencode-sshmaster", {
      "host": "my-server",
      "identityFile": "~/.ssh/id_ed25519",
      "forwards": [
        { "local": 3000, "remote": 3000 },
        { "local": 5432, "remote": 5432 }
      ]
    }]
  ]
}

OpenCode will automatically install the package from npm on next startup.

Configuration

| Option | Type | Required | Description | |--------|------|----------|-------------| | host | string | Yes | SSH hostname (as defined in ~/.ssh/config) | | identityFile | string | No | Path to SSH private key | | forwards | Tunnel[] | No | Port forwards to establish on connect |

Tunnel

| Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | local | number | Yes | — | Local port to bind | | remote | number | Yes | — | Remote port to forward to | | remoteHost | string | No | "localhost" | Remote host to forward to (relative to the SSH server) |

Commands

| Command | Description | |---------|-------------| | tunnel.add | Add a new port forward | | tunnel.remove | Remove an existing port forward | | tunnel.reconnect | Reconnect the SSH master connection |

All commands are available in the command palette (Ctrl+P / Cmd+P).

Requirements

• macOS or Linux
• OpenSSH client installed and in $PATH
• SSH access to the target host configured (key-based auth recommended)