mobilecode README

The project's README from github.com/hsandhu/mobilecode. As one markdown file: README.md.

mobilecode

The open source AI coding agent for mobile apps.

MobileCode is a fork of opencode that knows about mobile projects. When it detects an iOS or Android project it can run the simulator or emulator preview server and render the live device inside the app, next to your session.

React Native

Run a React Native app on iOS and Android from one Play button. MobileCode starts one Metro server, builds both native projects, and launches them in embedded Simulator and Emulator panes.

MobileCode building and running a React Native app on iOS and Android

MobileCode building and running an iOS app in the embedded simulator

How the device pane works

Open a session in a mobile project and the device pane opens by itself, alongside your conversation. It starts npx serve-sim or npx serve-avd on the machine running the MobileCode server and streams the simulator or emulator into the app, with Start, Stop, Reload and Open in browser controls. Projects are detected up to two directories below the session root, so an app in a subfolder is still found.

Build and run

The session titlebar carries an Xcode-style run control for every detected platform, showing the current build status next to it.

The same operations are available over HTTP:

GET  /api/device-preview?location[directory]=<project>
POST /api/device-preview/start      { "platform": "ios" | "android" }
POST /api/device-preview/stop       { "platform": "ios" | "android" }
POST /api/device-preview/run        { "platform": "ios" | "android" }
POST /api/device-preview/run/stop   { "platform": "ios" | "android" }

Requirements: macOS with Xcode for iOS (serve-sim needs Node 20 or newer), and the Android SDK platform-tools with at least one AVD for Android. Android builds need a JDK your project's Gradle version supports, and the package name is read from the built APK with aapt2 when the SDK build-tools are installed.

Installation

# Install script (downloads a release binary from GitHub)
curl -fsSL https://raw.githubusercontent.com/hsandhu/mobilecode/main/install | bash

# From source
git clone https://github.com/hsandhu/mobilecode.git
cd mobilecode
bun install
bun run --cwd packages/opencode src/index.ts

The install script places the binary in ~/.mobilecode/bin and adds it to your shell PATH.

Configuration and data

MobileCode keeps opencode's configuration format and locations, so an existing opencode.json, provider credentials, plugins, and skills work unchanged. Configuration lives in ~/.config/opencode, data in ~/.local/share/opencode, and environment variables keep the OPENCODE_ prefix. See the opencode docs for the full reference.

Development

bun install
bun run --cwd packages/opencode src/index.ts serve --port 4096   # backend
bun --cwd packages/app dev -- --port 4444                        # web UI at http://localhost:4444
bun --cwd packages/desktop dev                                   # desktop app

Run bun typecheck inside a package directory before sending changes. Tests run from package directories, for example bun test in packages/opencode.

Building the macOS app

bun run build:macos

One command: it installs dependencies, bundles the server, builds the Electron app and writes MobileCode.app plus a .dmg and .zip to packages/desktop/dist. It needs Node 20 or newer and picks a suitable version from nvm when the one on your PATH is older.

The build is unsigned by default, so right-click the app and choose Open the first time. To ship a signed and notarized build, pass --sign with a Developer ID certificate in your keychain and APPLE_API_KEY, APPLE_API_KEY_ID and APPLE_API_ISSUER set. Other options are --arch arm64|x64|universal, --channel dev|beta|prod and --skip-install; --help lists them.

License

MIT. MobileCode is built on opencode, copyright (c) 2025 opencode, and keeps its MIT license.

mobilecode (hsandhu/mobilecode)

Searching Database…

242 ·GitHub
Mobilecode
Что это?MobileCode — опенсорсный ИИ-агент для кодинга мобильных приложений, форк opencode. Обнаружив iOS- или Android-проект, он может запустить симулятор или эмулятор и показать живой предпросмотр прямо рядом с вашей чат-сессией.
Это CLI-инструмент или у него есть десктоп-приложение?Он наследует все интерфейсы opencode: терминальный UI, десктоп-приложение на Electron и веб-UI, плюс поддержку любых провайдеров моделей, MCP, плагинов и скиллов.
Что должно быть установлено для предпросмотра iOS- или Android-приложений?Для предпросмотра iOS нужен macOS с Xcode (и Node 20+ для serve-sim); для Android — Android SDK platform-tools хотя бы с одним AVD, плюс JDK, соответствующий версии Gradle вашего проекта.
Можно предпросматривать несколько мобильных проектов одновременно?Нет, симулятор, эмулятор и порт Metro общие, поэтому запуск нового проекта сначала автоматически останавливает работающие приложения других проектов.
Работает ли он с уже настроенным opencode?Да, MobileCode сохраняет формат конфигурации и расположение файлов opencode, так что существующие opencode.json, учётные данные провайдеров, плагины и скиллы работают без изменений.
Как он запускает приложения React Native или Expo?По нажатию Play поднимается один сервер Metro, при необходимости выполняется expo prebuild, ставятся pods, собираются оба нативных проекта, а Android-эмулятор подключается к Metro через adb reverse — приложение запускается сразу и на iOS, и на Android.
Что инструмент devicerun позволяет агенту?ИИ-агент может сам собрать и запустить приложение, дождаться результата и напрямую прочитать ошибку сборки и хвост логов, чтобы починить падающую сборку без вставки логов с вашей стороны.
Можно ли получить подписанную сборку приложения для macOS?По умолчанию сборка приложения macOS не подписана, но с --sign, сертификатом Developer ID и учётными данными ключа Apple API получаются подписанные и нотаризованные MobileCode.app, .dmg и .zip.
What are similar projects?Baize, skills, skills, 1code, zuse, kimi-code, acryl, lody-ios
Which topics is it in?gradle, expo, ide, xcode, bun, ai-coding, ai-tools, react-native, mobile-development, node, coding-agents, model-context-protocol
Creator
hsandhu
Size
310.8 MB
Stars
242
Updated
CommitOct 08Releasev1.18.35Oct 08
Age
1mo
Commits · 90 Days