Remote Control

Set up remote access to OpenCode. Execute all steps automatically without asking user confirmation (except for sudo commands).

Note: No password needed - Tailscale provides secure private network access.

Workflow

Execute these steps in order. Handle everything automatically.

Step 1: Check Tailscale CLI

which tailscale && tailscale version

If CLI not found, install via Homebrew:

brew install tailscale

Step 2: Check Tailscale Connection

tailscale status

If not connected or returns error, run:

tailscale up

If this opens a browser for authentication, inform user to complete login, then continue after they confirm.

Step 3: Get Tailscale IP

tailscale ip -4

Step 4: Start OpenCode Web Server

Check if server already running:

lsof -i :4096 -sTCP:LISTEN

If not running, start without password:

unset OPENCODE_SERVER_USERNAME OPENCODE_SERVER_PASSWORD
opencode web --hostname 0.0.0.0 --port 4096 &

Wait for server to start:

sleep 3 && lsof -i :4096 -sTCP:LISTEN

Step 5: Output Connection Info

Display to user:

• Tailscale IP
• Access URL: http://<tailscale-ip>:4096

Summary

After completing all steps, provide:

Remote Access Ready!

Tailscale IP: 100.x.y.z
Access URL: http://100.x.y.z:4096

[QR Code displayed]

To connect from another device:
1. Install Tailscale on that device
2. Sign in to the same Tailscale account
3. Scan the QR code or open the Access URL in browser

Troubleshooting