Mobile Harness

The complete autonomous AI development workspace for Android.

Chat with coding agents, edit projects, execute real Linux commands, inspect diffs, and preview live web servers — all directly on your phone.

Download Latest APK (v1.0.2)  •  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.

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     : v1.0.2
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

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.

Model Providers

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

[!NOTE] All credentials are stored with hardware-backed Android Keystore AES-256-GCM encryption. Keys are decrypted solely in-memory during active bridge operations.

Architecture

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["Claude Code CLI<br/>Autonomous Agent Harness"]
        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 Claude API"]
        Gateways["LLMrouter / Pocket Gateways"]
    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;

Core Runtime Components

• Base Environment: Ubuntu 20.04 ARM64 verified rootfs
• Agent Engine: Official Claude Code CLI package distributed directly from Anthropic
• Native Tooling: Node.js LTS, npm, Git, OpenSSL, curl, and GNU coreutils
• Process Virtualization: PRoot user-space architecture emulation with zero kernel modifications

System Requirements