Menu
Cross-compile and deploy the mclaude-relay binary to the remote VM. Use when the user wants to deploy, rebuild, or restart the relay.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Stand up a local k3d cluster and deploy mclaude to it. Builds images locally if ghcr.io images are unavailable. HTTPS via Let's Encrypt wildcard cert for *.mclaude.richardmcsong.com. DNS via DigitalOcean + ExternalDNS. Idempotent — safe to re-run.
Trigger any CI deploy and monitor it using local tools. CI builds and deploys; local kubectl/gh are for observing only.
Build and restart the mclaude-connector in its tmux window. Use when the user wants to deploy, rebuild, or restart the connector.
Build and restart mclaude-server as a launchd service. Use when the user wants to deploy, rebuild, or restart the server.
Based on SOC occupation classification
| name | deploy-relay |
| description | Cross-compile and deploy the mclaude-relay binary to the remote VM. Use when the user wants to deploy, rebuild, or restart the relay. |
Build and deploy the mclaude-relay binary to a remote VM.
Credentials are stored in environment variables or local files — never hardcoded here.
RELAY_HOST: hostname or IP of the relay VMRELAY_SSH_USER: SSH username for the VM~/.unixpasswordCross-compile the relay for linux/amd64:
cd mclaude-relay && GOOS=linux GOARCH=amd64 go build -o relay-linux .
Upload the binary to the VM:
scp mclaude-relay/relay-linux $RELAY_SSH_USER@$RELAY_HOST:/tmp/relay-linux-new
Run the deploy script remotely:
ssh $RELAY_SSH_USER@$RELAY_HOST 'sudo bash /tmp/deploy-relay.sh 2>&1'
If the deploy script doesn't exist or is stale, create and upload it. The script should:
TUNNEL_TOKEN, WEB_TOKEN, PORT, TUNNEL_STATIC/tmp/relay.logVerify the relay is running:
ssh $RELAY_SSH_USER@$RELAY_HOST 'curl -s http://localhost/health'
/tmp/relay-linux/tmp/deploy-relay.sh/tmp/relay.logTUNNEL_STATIC=true proxies static file requests through the tunnel to the connector for hot-reload dev mode.TUNNEL_STATIC_HOST pins static serving to a specific laptop hostname.TUNNEL_STATIC is off, the relay serves embedded static files from the binary.