English | 中文

An Android client for the OpenCode AI coding assistant. Connect to your PC, chat with AI, manage sessions across all projects, and track task progress — all from your phone.

• Multi-server management — add and switch between multiple OpenCode servers from the home screen
• Multi-project discovery — automatically finds and lists sessions from all projects, regardless of which directory the server was started from
• Optional child-session filtering — hide sub-sessions from project lists when you only want root conversations
• HTTPS (TLS) support — connect through HTTPS reverse proxies (Lucky, Nginx, Caddy, etc.) with optional self-signed certificate trust
• In-app update check — automatically checks GitHub for new versions on startup, one-tap APK download & install (proxied for China)
• Background SSE stability — foreground service keeps the connection alive when the app is in background
• State persistence across app kill — question/permission bubbles and streaming output survive process death via disk cache; re-enter any session and pick up exactly where you left off
• Unified chat settings — configure Agent, Model, and Variant per-session from a single Settings dialog in the chat input bar
• Variant selection — choose specific model variants (e.g. quantization levels) when the server provides them
• Time-based session grouping — sessions grouped by Today / Yesterday / This Week / Older with relative timestamps
• Child session tree — expand/collapse child sessions in a tree layout under their parent
• Session search — debounced search bar to filter sessions by title
• Active session status dots — real-time green pulsing dots indicate busy sessions
• Real-time AI chat with SSE streaming
• Tool call rendering (thinking bubbles, tool summaries)
• Todo task panel overlay
• Agent picker (switch between AI agents)
• Session fork / delete
• Manual dark mode toggle (🌙/☀️ button)
• EN/ZH bilingual toggle (in-app)
• Password encrypted storage (EncryptedSharedPreferences)
• SSE auto-reconnection with exponential backoff
• Chinese/non-ASCII path support — works with project directories containing Chinese, Japanese, Korean, or other Unicode characters

1. Go to GitHub Releases
2. Download app-release.apk from the latest release
3. Open the file on your phone, allow "Install from unknown sources"
4. Open OConnector and connect to your PC

Requires Android 8.0+ (API 26)

gradlew.bat assembleDebug     # Windows
./gradlew assembleDebug       # macOS / Linux

The APK will be at app/build/outputs/apk/debug/.

Using the startup script (recommended):

scripts\start-server.bat       # Windows
bash scripts/start-server.sh   # macOS / Linux

Manual start:

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

You can start the server from any directory — OConnector will discover all projects automatically.

Verify: Open http://<PC_IP>:4096 in your phone's browser.

Firewall: Allow inbound port 4096.

1. Open OConnector → tap + on the Server List screen to add your first server
2. Enter PC IP, port, and credentials → tap Connect
3. The session list shows all projects and sessions across your PC
4. Tap a project to see its sessions, tap a session to enter chat
5. Expand/collapse child sessions in the tree view, send messages, switch agents, track todos

If you use a reverse proxy (Lucky, Nginx, Caddy, etc.) to expose OpenCode with HTTPS:

1. Enter the proxy domain (e.g. opencode.example.com) and port
2. Enable "Use HTTPS (TLS)" toggle
3. If your proxy uses a self-signed certificate, also enable "Allow untrusted certificates"
4. Tap Connect

Tip: For LAN setups without a domain, you can also use Tailscale HTTPS or configure local DNS.

app/src/main/java/com/opencode/remote/
├── data/
│   ├── api/          # REST + SSE clients
│   ├── dto/          # Data models
│   ├── datastore/    # Preferences
│   ├── download/     # DownloadManager + FileProvider install
│   ├── github/       # GitHub Releases API + version compare
│   ├── repository/   # Repository pattern
│   └── sse/          # SSE event bus
├── service/          # Foreground service
├── ui/
│   ├── connection/   # Connect / Add Server screen
│   ├── serverlist/   # Server list (home screen)
│   ├── sessions/     # Project + session list
│   ├── chat/         # Chat + streaming + tools
│   ├── help/         # Help screen
│   ├── theme/        # Material3 theme
│   └── strings/      # i18n
└── AppNavigation.kt  # Nav graph

OConnector auto-discovers all projects. Make sure the server is running and the phone can reach it. Check the server console for errors.

The project may not have any sessions yet. Tap the FAB to create one.

Yes. The OpenCode server supports multiple clients.

• Only use on trusted local networks
• Use Tailscale / ZeroTier for remote access (encrypted)
• Do not expose port to the public internet
• Passwords encrypted locally via EncryptedSharedPreferences

• PR (community-contributed) versions are named in the format v_pr<version> (e.g. v_pr2, v_pr3).
• PR versions are released separately from the main branch releases and contain features that have not yet been merged into main.
• All PRs should be merged into the pr_version branch.
• Contributors are expected to perform final checks and ensure compatibility with the latest pr_version branch before submitting.
• The pr_test branch is a backup/testing-only branch and should not be used as the merge target.

1. Fork → branch → commit → push → PR
2. Ensure code compiles and is compatible with the latest pr_version branch
3. Describe changes in the PR

MIT License