OpenCode Mobile

A React Native / Expo app for connecting to OpenCode servers from your phone.

Features

• Multiple Connection Types: Connect via local network, tunnels (Cloudflare/ngrok), or cloud-hosted instances
• Secure Authentication: Biometric authentication (Face ID/Touch ID) support
• Session Management: View, create, and manage coding sessions
• Real-time Chat: Stream responses from your AI assistant
• File Diff Viewer: See what changes were made to your code

Getting Started

Prerequisites

• Node.js 18+
• Bun (recommended) or npm
• Expo Go app on your phone (for development)

Installation

# From the monorepo root
cd packages/mobile
bun install

# Start the development server
bun start

Connecting to OpenCode

1. Start OpenCode in server mode on your machine:

   OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096

2. Open the app and add a connection:

   • Local Network: Use your machine's local IP (e.g., http://192.168.1.100:4096)
   • Tunnel: Set up a Cloudflare Tunnel or ngrok and use the tunnel URL
   • Cloud: Connect to a hosted OpenCode instance

Building for Production

iOS

bun run ios
# or
eas build --platform ios

Android

bun run android
# or
eas build --platform android

Security

• Credentials are stored securely using expo-secure-store (iOS Keychain / Android Keystore)
• Optional biometric authentication for app access
• Optional biometric confirmation for sending messages
• All traffic should use HTTPS for non-local connections

Architecture

packages/mobile/
├── app/                  # Expo Router screens
│   ├── (tabs)/          # Tab navigation
│   ├── session/         # Session screens
│   └── connection/      # Connection management
├── src/
│   ├── components/      # Reusable components
│   ├── hooks/           # Custom hooks
│   ├── lib/             # SDK client & types
│   └── stores/          # Zustand state stores
└── assets/              # App icons & images

Contributing

This is part of the OpenCode monorepo. See the root README for contribution guidelines.