Mobile Harness
The complete autonomous AI development workspace for Android.
Chat with coding agents, edit projects, execute real Linux commands, and preview live web servers — all directly on your phone.
Download Online APK •
Watch Walkthrough (3 min) •
Quickstart Guide •
Architecture •
Build from Source
[!IMPORTANT]
Environment Security Notice
Mobile Harness runs on ARM64 Android devices using a private userspace PRoot layer. While isolated from other apps via standard Android sandbox permissions, PRoot is not a virtualization boundary or hardened security jail. Only execute projects and dependencies you own or trust.
Download Mobile Harness
Capabilities
Mobile Harness unites modern Jetpack Compose UI with a self-contained Ubuntu 20.04 LTS subsystem. It gives you a desktop-class software development environment in your pocket without requiring root access, unlocked bootloaders, or external applications like Termux.
Workspace Interface
Quickstart
Get up and running in 3 guided steps:
1. Download & Install
Download the latest signed release APK from GitHub Releases.
Target Architecture : ARM64 (arm64-v8a)
Package Version : latest release
Minimum OS Level : Android 9.0 (API 28)
2. Guided Bootstrap (~10 Minutes)
Launch the application and follow the interactive setup wizard:
3. Create & Build
- Tap New Project or launch an instant Quick Project.
- Open the AI Workspace and describe what you want to build.
- Watch the agent inspect files, draft code, run builds, and launch local web previews.
Model Providers
Mobile Harness uses Claude Code's Anthropic-compatible API protocol. You can connect official endpoints or route requests through compatible translation proxies:
| Provider | Integration Type | Streaming | Tool Calling | Status | Notes |
|---|
| Anthropic API | Direct Key | Supported | Supported | Recommended | Primary supported backend |
| OpenRouter | Gateway | Supported | Supported | Supported | Routes compatible models through one API key |
| DeepSeek | Direct Key | Supported | Supported | Supported | Anthropic-compatible endpoint |
| Kimi | Direct Key | Supported | Supported | Supported | Anthropic-compatible Moonshot endpoint |
| Custom API | Endpoint Override | Compatible | Compatible | Experimental | User-configured gateway |
[!NOTE]
API keys are stored with hardware-backed Android Keystore AES-256-GCM encryption. Antigravity Google OAuth credentials are created and retained only by the official agy CLI in its persistent Linux home; Mobile Harness never reads or copies its tokens.
Coding agents
| Agent | Authentication | Installation | Isolation |
|---|
| Claude Code | Claude account or API-key providers | Included in Core | Existing Claude bridge and settings |
| DeepSeek Harness | API-key providers | On demand | Existing DSH bridge and settings |
| Antigravity CLI | Official Google OAuth flow | Version-pinned online download | Dedicated agy bridge, model, effort, and conversation IDs |
For Antigravity, select Antigravity CLI, install it, and tap Sign in with Google. Mobile Harness starts the official CLI login, opens the freshly generated Google URL in the system browser, and sends the returned one-time code back to that waiting process. The app does not embed Google login in a WebView and does not construct its own OAuth request.
[!WARNING]
Antigravity tasks currently launch with --dangerously-skip-permissions. This gives the official agent permission to run tools without individual PocketDev approval prompts. Use it only with projects and prompts you trust. Account quotas and service limits still apply; signing in does not provide unlimited usage.
When Android is selected during onboarding, Mobile Harness installs that complete toolchain into its private Ubuntu environment. Android projects can then be built with the workspace play button. The resulting debug APK is passed directly to Android's system package installer and launched after installation; USB debugging, wireless debugging, an ADB port, and a pairing code are not required. Android still requires the user to allow installs from Mobile Harness and confirm each installation.
Architecture
Mobile Harness bridges native Android Jetpack Compose to an isolated PRoot Linux execution layer via an optimized C++ JNI bridge:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
