Run coding agents locally on Android through a native GUI — no terminal required.
AndCode is a native Android GUI app that brings AI coding agents to your phone. Chat with OpenCode and Claude Code through a touch-first interface — no terminal, no SSH, no PC required for on-device use. It wraps agent runtimes via PRoot (on-device) or connects remotely to your existing OpenCode server on PC/Mac/Linux.
Important
AndCode is an independent open-source project. It is not affiliated with OpenCode or Anthropic.
| Agent | On-Device | Remote PC | Status |
|---|---|---|---|
| OpenCode | ✓ | ✓ | Stable |
| Claude Code | ✓ | — | Beta |
On-device agents run inside an Alpine Linux environment via PRoot. Remote OpenCode connects to a running opencode serve instance on your PC, Mac, or Linux machine over LAN or Tailscale.
- Native Android GUI — Touch-first interface for coding agents; no CLI or terminal required
- On-device runtime — Alpine Linux, Git, bash, curl, ripgrep, and coding agents auto-installed on your Android device via PRoot
- Repository & workspace — Open and work within git repositories on-device
- Git support — Stage, diff, commit, and manage branches from the GUI
- Diff viewer — Review code changes inline before accepting
- Tool approvals — Approve or reject dangerous tool operations
- Session management — Create, resume, rename, and delete sessions
- Dynamic models — Models, providers, and agents fetched live from your connected agent instance
- Real-time streaming — SSE-based live responses, tool execution, and approval requests
- Structured timeline — Collapsible reasoning, tool calls, and command output
- Voice + Wake Word — Push-to-talk with Android speech recognition + wake word detection
- Text-to-speech — Read responses aloud
- Digital assistant — Register as Android's default assistant (home gesture / corner swipe)
- Secure storage — Connection credentials encrypted with Android Keystore
- Bilingual — English and Japanese UI
In addition to on-device agents, AndCode can connect to OpenCode running on your PC/Mac/Linux as an additional feature:
- Remote connection — Connect over LAN or Tailscale
- Runtime switching — Seamlessly switch between local and remote execution, even mid-conversation (handoff)
- Discovery — Find PCs via QR code or mDNS (zero-config LAN discovery)
| Screen | Description |
|---|---|
| Home | Current runtime, model, agent, recent sessions |
| Chat | Conversation with collapsible reasoning/tools, voice input, model switching, approvals, handoff |
| Workspaces | Local runtime, PC connections, working folders |
| History | Running tasks, pending approvals, sessions, event log |
| Settings | Home assistant, TTS, continuous conversation, configuration |
- Install the APK from Releases
- Open the app → tap Workspaces → This Android device → Set up on this device
- Wait for the runtime to download and install (~2 min on a good connection)
- Select your coding agent and start chatting
- Start OpenCode on your PC:
OPENCODE_SERVER_PASSWORD='your-strong-password' \
opencode serve --hostname 0.0.0.0 --port 4096 --mdns- Install the APK on your Android device
- Open the app → Workspaces → Add connection
- Enter your PC's IP (or use LAN search / QR code for auto-discovery)
Name: Mac mini
URL: http://192.168.1.10:4096
Username: opencode
Password: your-strong-password
Tailscale works too:
http://100.x.y.z:4096orhttp://your-mac.tailnet-name.ts.net:4096
Generate a QR code on your PC:
npx qrcode "opencode://connect?name=Mac%20mini&url=http%3A%2F%2F192.168.1.10%3A4096&username=opencode&password=your-password&insecure=true"Then scan it from Workspaces → Add via QR in the app.
- Never expose port 4096 directly to the internet
- Use LAN or Tailscale for connectivity
- Use an HTTPS reverse proxy on public networks
- The app never auto-approves dangerous operations
- Plaintext HTTP on LAN requires explicit per-connection opt-in
The setup process (triggered from Workspaces):
- Verifies the native PRoot runner bundled in the APK
- Downloads Alpine Linux minirootfs from the official CDN
- Downloads the agent binary from GitHub Releases
- Validates SHA-256 checksums for both
- Extracts to a private app directory
- Installs Git, bash, curl, ripgrep, and CA certificates inside Alpine
- Starts the agent server on
127.0.0.1:4097 - Switches the app to the local runtime
Pinned versions (updatable via app releases without agent changes):
- Alpine Linux 3.24.1
- OpenCode 1.18.3
- Architectures: arm64-v8a, x86_64
From the chat header menu → Continue on another runtime — the app generates a conversation summary prompt and sends it to the selected runtime, letting you pick up where you left off (e.g., start on-device while commuting, continue on your PC at home).
Add server config to ~/.config/opencode/opencode.json:
{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true
}
}Restart the desktop app, then discover it from the Android app via LAN search.
Requirements: JDK 17, Android SDK, Python 3, network access (first build only)
./gradlew testDebugUnitTest lintDebug assembleDebug assembleReleaseOutput APKs:
app/build/outputs/apk/debug/app-debug.apk
app/build/outputs/apk/release/app-release-unsigned.apk
Install to device:
adb install -r app/build/outputs/apk/debug/app-debug.apkContributions are welcome! Please see CONTRIBUTING.md for guidelines.
Runtime generation reuses generic Termux package resolution/extraction logic redesigned for coding agents, inspired by the MIT-licensed Hermes Agent Android implementation. See THIRD_PARTY_NOTICES.md for details.