A native iOS client for OpenCode. Connect to your OpenCode server from your iPhone or iPad to chat with AI agents, monitor tool calls in real time, and browse code changes on the go.

Don't want to build from source? Join the TestFlight beta:

https://testflight.apple.com/join/2cWrmPVq

No Apple Developer account needed. Just tap the link on your iOS device.

• Chat: send messages, switch models, view AI replies with streaming, inspect tool calls and reasoning
• Files: file tree browser, session diffs, markdown preview, image preview with zoom/pan, code view with line numbers
• Settings: server connection, Basic Auth, SSH tunnel, theme, voice transcription

• iOS 17.0+
• A running OpenCode server (opencode serve or opencode web)
• Xcode 16+ (only if building from source)

1. Start OpenCode on your Mac: opencode serve --port 4096
2. Open the iOS app, go to Settings, enter the server address (e.g. http://192.168.x.x:4096)
3. Tap Test Connection
4. Switch to Chat, create or select a session, and start talking

The app is designed for LAN use by default. Two options for remote access:

HTTPS + public server (recommended): deploy OpenCode on a public server with TLS. Point the iOS app to https://your-server.com:4096 and configure Basic Auth credentials.

SSH Tunnel: the app has a built-in SSH tunnel (powered by Citadel). Set up a reverse tunnel from your home machine to a VPS, then configure the tunnel in Settings > SSH Tunnel. See docs/ for detailed steps.

git clone https://github.com/grapeot/OpenCodeClient.git
cd OpenCodeClient/OpenCodeClient
open OpenCodeClient.xcodeproj

Select the OpenCodeClient scheme, pick a simulator or device, and hit Run. Swift Package dependencies resolve automatically on first build.

MIT