opencode-serve-lan

Access OpenCode web from your phone or any device on your local network.

Runs opencode serve on all interfaces with a macOS menu bar widget (via xbar) showing status, URL, and a scannable QR code.

What you get

• Auto-starting service — opencode serve runs on boot, survives sleep/wake
• Menu bar widget — green >_ when running, gray when stopped. Click to see URL, QR code, and start/stop controls
• CLI tool — opencode-forward {start|stop|status|logs|uninstall}
• Dynamic QR code — always reflects your current local IP, works across networks

Install

git clone https://github.com/pedrio-gh/opencode-serve-lan.git
cd opencode-serve-lan
bash install.sh

Custom port (default is 4096):

bash install.sh 8080

Requirements

• macOS
• OpenCode installed
• Homebrew

The installer handles xbar and qrencode automatically.

Usage

Menu bar

Click the >_ icon to:

• See the current URL
• Scan QR code from your phone
• Copy URL to clipboard
• Start / Stop the service

CLI

opencode-forward start     # Start the service
opencode-forward stop      # Stop the service
opencode-forward status    # Show status and URL
opencode-forward logs      # Tail service logs
opencode-forward uninstall # Remove the service

Uninstall

bash uninstall.sh

License

MIT