Skip to content

apuyou/mobilecode

Repository files navigation

MobileCode logo

A mobile client for OpenCode

Try it on 🍏TestFlight or 🤖Google Play

License

Note

This project is not affiliated with or endorsed by OpenCode in any way.


Recent Sessions    Server Sessions    Chat


About

MobileCode lets you control your OpenCode sessions remotely from your phone. Connect to an OpenCode server running on your machine, browse projects and sessions, and chat with the AI coding agent — all from your pocket.

OpenCode's client/server architecture makes this possible: OpenCode runs on your computer while you drive it from anywhere using MobileCode as a remote client.

The app currently requires a direct network connection to your OpenCode server, so it's best used on the same local network or via a VPN like Tailscale. Future updates may include cloud sync for remote access without a VPN.

Features

  • Multi-server management: connect to multiple OpenCode instances, with built-in connection testing
  • Project browsing: browse all projects detected by each OpenCode server
  • Session management: list, create, and archive sessions across all your projects
  • Chat interface: full conversational UI with Markdown rendering and tool invocation cards
  • Agent and model selection: switch between agents and models on the fly
  • Dark mode: follows your system theme

Download

Platform Beta Store
iOS TestFlight Coming Soon!
Android Google Play Coming Soon!

Setup

Warning

Do not expose OpenCode to the public Internet without configuring a password! See OpenCode documentation for all available options.

  1. Install and configure Tailscale on the computer you use for OpenCode as well as your phone
  2. Start OpenCode on your machine, listening on its Tailscale IP (you can copy it from the Tailscale app):
    opencode web --hostname=100.x.x.x
  3. Open MobileCode on your phone
  4. Add a server with the URL of your machine (e.g. http://100.x.x.x:4096)
  5. Start coding

Tech Stack

Layer Technology
Framework Expo SDK 55 + expo-router
Language TypeScript
UI React Native + NativeWind (Tailwind)
State Zustand + MMKV persistence
Data Fetching TanStack React Query
API Client @opencode-ai/sdk

Contributing

Contributions are welcome! Feel free to open issues and pull requests.

About

Unofficial OpenCode mobile client

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors