engineering / agent

Mobile Harness

An Android app for chatting with coding agents, running Linux commands, editing files and previewing web servers on your phone.

Repository owner techjarves

Not rated yet
0 comments

Like 0 Save

Published 11 Oct 2026Listing updated 12 Oct 2026

At a glance

Purpose: An Android app for chatting with coding agents, running Linux commands, editing files and previewing web servers on your phone.
Runs in: Local agent with shell
Operating systems: Not stated
Needs: Runtime: Bundled Ubuntu 20.04 LTS subsystem; Needs internet: Not stated; Needs accounts or API keys beyond your agent: Not stated
Files and data: Reads files: Yes; Writes files: Yes; Sends data to other services: No
Tool type: Agent
Delivery: From GitHub
Version: Latest on the main branch
Access: Code on GitHub
Compatibility: According to the README: ARM64 (arm64-v8a) Android devices on Android 9.0 (API 28) or newer, with Android 13.0 or newer recommended. Coding agents: Claude Code, DeepSeek Harness and Antigravity CLI. Model providers: Anthropic API, OpenRouter, DeepSeek, Kimi and a custom API endpoint. Optional toolchains: Python, Android and JVM, C and C++, and PHP.
External costs: According to the README, you connect your own model provider: the Anthropic API, OpenRouter, DeepSeek, Kimi or a custom endpoint with an API key, a Claude account for Claude Code, or a Google sign-in for Antigravity CLI. The README says account quotas and service limits still apply to Antigravity. The README gives no prices. The provider you connect may charge for usage.
Permissions: The README describes installing an APK and a private Ubuntu userspace with development toolchains, including on-demand downloads and agent installation. The README names a foreground runtime service with process lifecycle management and WakeLocks. The README describes API-key providers, Claude account access and Antigravity Google sign-in through the agy CLI. The README says agents inspect and edit files, run builds and launch local web previews, while the terminal executes Linux commands. The README warns that PRoot is not a virtualization boundary or hardened security jail. The README describes Android Storage Access Framework import and export, and user confirmation for installing built APKs. The README warns that Antigravity launches with --dangerously-skip-permissions and runs tools without individual approval prompts. The top-level file list includes scripts/, whose contents the README does not describe.
Usage terms: MIT License, as stated in the repository. See its LICENSE file for the exact terms. The README adds that third-party runtime binaries and packages remain governed by their own upstream licenses.

Code on GitHub

techjarves/Mobile-Harness

MIT

Kotlin590 stars182 forksLast pushed 11 Oct 2026 UTC

Claude Code on Android: AI-powered mobile coding IDE for Android — chat with a coding agent, run Linux commands, edit files, review diffs, and preview web apps directly from your phone. No root required.

Topics: claude-code mobile-ide

Public GitHub data fetched 13 Oct 2026 UTC · 0 days old

View on GitHub ↗

What it does

Mobile Harness is an Android app. According to the README, it pairs a Jetpack Compose interface with an Ubuntu 20.04 ARM64 userspace that runs inside PRoot, and it needs no root access. The README says you can chat with coding agents, edit project files, run Linux commands and preview web servers from the phone.

The README names Claude Code, DeepSeek Harness and Antigravity CLI as its coding agents. The README lists Node.js, npm, Git, OpenSSL and curl in the Linux environment, and Python, Android and JVM, C and C++, and PHP tooling as optional downloads. The README describes a web preview for servers such as Vite, Next.js and Express, and Android builds that install on the same phone without USB or wireless ADB.

The README says you install an APK from the project's GitHub releases, run a guided setup and connect a model provider. The README lists the Anthropic API, OpenRouter, DeepSeek, Kimi and a custom API endpoint. The README also says Mobile Harness is an independent project and is not affiliated with Anthropic.

Who it is for

Developers who want to chat with coding agents and use a Linux environment on an ARM64 Android phone.

Example tasks

Install the APK on an ARM64 Android phone and follow the guided setup.
Connect a model provider such as the Anthropic API.
Create a new project and describe what you want to build in the AI Workspace.
Preview a local web server inside the app.
Build an Android project and install the debug APK on the same phone.

Getting started

According to the README, you download the online or offline APK from the project's GitHub releases and install it on an ARM64 device running Android 9 or newer. You then follow the guided setup in the app (system readiness, toolchains and AI provider), which the README puts at about 10 minutes. Next you tap New Project or Quick Project and describe what you want to build in the AI Workspace. To build the app from source, the README lists Android Studio prerequisites and gives ./gradlew assembleDebug. The README has the exact commands.

Limitations

According to the README, Mobile Harness requires an ARM64 device with Android 9.0 or newer, at least 4 GB RAM and 2.5 GB free storage for the base runtime; Android 13.0 or newer is recommended. The README requires a stable connection for setup and model access and labels Custom API integration experimental. The README says PRoot is not a virtualization boundary or hardened security jail and advises using projects and dependencies the user owns or trusts. The README says Docker, KVM, systemd services and nested hardware emulators are unsupported. The README warns about incomplete full-screen terminal rendering, Android background and battery restrictions, slow or memory-intensive large builds and missing Claude-compatible behavior in custom providers. The README warns that Antigravity launches with --dangerously-skip-permissions, without individual tool approval prompts, and remains subject to account quotas and service limits. The README says distribution is currently intended for signed direct APKs and private testing. The repository can change at any time; check its README before you install.

Data practices

The README says Mobile Harness connects the device directly to the chosen AI endpoint and stores API keys with Android Keystore-backed AES-256-GCM encryption. The README says the agy CLI creates and retains Antigravity OAuth credentials in its persistent Linux home. The README describes local projects, chat history, files and task context, and Storage Access Framework import and export. The README uses the phrase “console telemetry” for web-preview output and describes direct connections to the chosen AI endpoint rather than intermediate relays or telemetry servers. It gives no external telemetry payload or opt-out variables. The README says setup downloads Claude Code from Anthropic's distribution endpoints and Gradle may download project libraries. The README points to PRIVACY.md for the full policy.