| name | remote-control |
| description | Enable remote access to your local OpenCode session using Tailscale VPN. Automatically installs Tailscale, connects to tailnet, starts the web server, and provides a private URL. Use when you want to access OpenCode from another device (phone, tablet, another computer), continue coding remotely, or set up secure remote development. Triggers: "remote control", "access opencode remotely", "remote access", "continue from phone", "tailscale opencode", "start remote access". |
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
| Issue | Solution |
|---|
| App Store Tailscale CLI crashes | Install Homebrew CLI: brew install tailscale |
| Port 4096 in use | Use different port: --port 4097 |
| sudo required for symlink | Inform user to run: sudo ln -s /Applications/Tailscale.app/Contents/MacOS/Tailscale /usr/local/bin/tailscale |
