techjarves/Mobile-Harness

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  •  Download Offline APK  •  Watch Walkthrough (3 min)  •  Quickstart Guide  •  Architecture  •  Build from Source

_{Watch the product walkthrough and demo  |  Setting up Ubuntu, connecting Claude Code, and building an app on Android}

Online Edition 89.1 MB · Recommended Start with the smaller APK. Core, Python, and Android runtime bundles are downloaded only when needed.

Offline Edition 889.4 MB · Everything included Includes the Core, Python, and Android runtime bundles for setup with limited or unavailable internet.

ARM64 Android 9+
_{Direct APK installation · No root required · No USB or wireless ADB pairing}

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.

Projects	Terminal	Settings
Create, organize, and resume isolated workspace sessions.	Execute real Linux commands and scripts with instant output.	Manage AI providers, installed toolchains, themes, and runtime health.

Get up and running in 3 guided steps:

Download the latest signed release APK from GitHub Releases.

Target Architecture : ARM64 (arm64-v8a)
Package Version     : v1.0.7
Minimum OS Level    : Android 9.0 (API 28)

Launch the application and follow the interactive setup wizard:

1 · System Readiness	2 · Toolchains	3 · AI Provider
Verifies device storage, CPU architecture, and background service permissions.	Select core Ubuntu runtime and optional development stacks.	Securely store your API keys in Android Keystore.

1. Tap New Project or launch an instant Quick Project.
2. Open the AI Workspace and describe what you want to build.
3. Watch the agent inspect files, draft code, run builds, and launch local web previews.

Mobile Harness uses Claude Code's Anthropic-compatible API protocol. You can connect official endpoints or route requests through compatible translation proxies:

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.

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.

Mobile Harness bridges native Android Jetpack Compose to an isolated PRoot Linux execution layer via an optimized C++ JNI bridge:

flowchart TB
    subgraph Host[" Android Native Host (Kotlin + Jetpack Compose) "]
        UI["Modern UI Layer<br/>Projects • Chat • Terminal • Web Preview"]
        Service["Foreground Runtime Service<br/>Process Lifecycle & WakeLocks"]
        Keystore["Android Keystore<br/>AES-256 GCM Credentials"]
        Bridge["C++ JNI Process Bridge<br/>Native Launcher & Pipe Multiplexer"]
    end

    subgraph Subsystem[" Private Linux Subsystem (PRoot ARM64) "]
        Ubuntu["Ubuntu 20.04 LTS Subsystem<br/>Rootless Userspace Environment"]
        Agent["Agent Registry<br/>Claude • DeepSeek • Antigravity"]
        Tools["Development Toolchains<br/>Node.js • Git • Python • C++"]
        Workspace["Local Project Workspace<br/>Files • Git History • Checkpoints"]
    end

    subgraph Cloud[" Model Providers "]
        Anthropic["Anthropic / API Gateways"]
        Gateways["Google Antigravity Service"]
    end

    UI <--> Service
    Service <--> Bridge
    Bridge <--> Subsystem
    Keystore -.-> UI
    Agent <--> Cloud
    Agent --> Tools
    Tools <--> Workspace
    UI -.-> Workspace

    classDef hostStyle fill:#0f172a,stroke:#38bdf8,stroke-width:1.5px,color:#f8fafc;
    classDef subStyle fill:#1e1b4b,stroke:#818cf8,stroke-width:1.5px,color:#f8fafc;
    classDef cloudStyle fill:#18181b,stroke:#f59e0b,stroke-width:1.5px,color:#f8fafc;

    class UI,Service,Keystore,Bridge hostStyle;
    class Ubuntu,Agent,Tools,Workspace subStyle;
    class Anthropic,Gateways cloudStyle;

• Base Environment: Ubuntu 20.04 ARM64 verified rootfs
• Agent Engine: Registry-selected, isolated drivers for Claude Code, DeepSeek Harness, and the official Antigravity CLI
• Native Tooling: Node.js LTS, npm, Git, OpenSSL, curl, and GNU coreutils
• Process Virtualization: PRoot user-space architecture emulation with zero kernel modifications

# Clone the repository
git clone https://github.com/techjarves/Mobile-Harness.git
cd Mobile-Harness

# Build the standard ARM64 debug binary
./gradlew assembleDebug

# Deploy directly to a connected test device
adb install -r app/build/outputs/apk/debug/app-debug.apk

# Run unit tests
./gradlew testDebugUnitTest

# Run static analysis linter
./gradlew lintDebug

Mobile-Harness/
├── app/src/main/
│   ├── java/com/jarves/mh/
│   │   ├── data/       # Preferences, Keystore AES encryption, SQLite persistence
│   │   ├── model/      # Data entities: Projects, Chats, Files, Tool calls
│   │   ├── runtime/    # PRoot installer, C++ agent bridge, foreground services
│   │   └── ui/         # Jetpack Compose screens, Material 3 theme, ViewModels
│   ├── cpp/            # Native C++ launcher, pseudo-terminal pipe handler
│   ├── assets/         # Verified rootfs checksums, licenses, base configuration
│   └── res/            # Android icons, XML drawables, vector assets
├── fastlane/           # Play Store metadata, graphics, and release automation
└── docs/               # In-depth architectural notes & Play Store review guides

Mobile Harness is currently intended for signed direct APK distribution and private testing. Its Android-project workflow requests permission to submit user-built APKs to Android's package installer, which requires a dedicated Google Play policy declaration and approval if distributed through Play.

• Architecture: Exclusively supports 64-bit ARM (arm64-v8a) hardware.
• Process Isolation: PRoot maps file systems and IDs in user space; it is not a cryptographically hardened container or VM.
• Terminal Emulation: The process bridge handles standard CLI workflows and REPLs; specialized ncurses applications may experience minor layout artifacts.
• OS Process Management: Heavy compilation workloads may be throttled if Android applies aggressive battery optimization. It is recommended to exempt Mobile Harness from battery optimization in device settings.

• Mobile Harness is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Anthropic.
• Claude and Claude Code are trademarks of Anthropic, PBC. Claude Code CLI is downloaded directly from Anthropic's official distribution endpoints during setup and remains governed by Anthropic's license terms.
• Ubuntu, Android, Kotlin, Node.js, Git, and other registered trademarks belong to their respective copyright holders.
• Third-party open-source licenses are compiled in app/src/main/assets/licenses.

This project is licensed under the MIT License. Third-party runtime binaries and packages remain governed by their respective upstream licenses.