Android ยท Full Linux ยท No Server Required

Claw Code on your phone

The 48K+ star open-source AI coding agent framework โ€” running natively on Android in a full embedded Linux environment. No Mac. No PC. No server. Just your phone.

โฌ‡ Download APK โ–ถ Google Play GitHub
48k+
Upstream Stars
19
Built-in Tools
15
Slash Commands
0
Servers Needed
๐Ÿ“ฑ Screenshots โšก Features ๐Ÿ”ง 19 Tools ๐Ÿ— Architecture ๐Ÿš€ Boot Sequence โš– Mobile vs Desktop โŒ˜ Quick Start ๐Ÿ“Š Tech Stack ๐Ÿ“‹ Release Notes

Running on a real phone

This is not a mockup. This is a full AI coding agent reading your codebase, writing code, and executing commands โ€” on an Android device.

Claw Code Mobile โ€” AI Coding Agent
AI Coding Agent
Claw Code Mobile โ€” Dashboard
Dashboard & Sessions

Why run an AI coding agent on a phone?

Modern phones have 8+ ARM64 cores and 8GB+ RAM. They don't need a server to run an AI agent. They just needed the right software.

๐Ÿšซ

No Server Costs

$0/month. No cloud VMs. No SSH tunnels. No port forwarding. Your phone is the server.

๐Ÿ“ฑ

Always With You

Code on the bus, in a cafรฉ, at the dentist. Wherever your phone goes, your AI agent goes.

โšก

Instant Setup

Download APK โ†’ Open โ†’ Login โ†’ Code. No terminal. No pip install. No dependency hell.

๐Ÿ”

Your Data, Your Device

Everything runs locally. No third-party servers seeing your code. Privacy by architecture.

๐Ÿง

Real Linux

Full Termux-derived userland with sh, apt, Node.js, Python, and SSL certs. Not a simulation.

๐Ÿฆ€

Rust Performance Core

73MB native aarch64-musl binary. 6 Rust crates. 16 runtime modules. Raw native speed.

Full agent capabilities

Everything the desktop Claw Code agent does โ€” tools, commands, MCP, multi-agent โ€” all running on your phone.

๐Ÿ”ง

19 Built-in Tools

File I/O, Bash execution, Git operations, web scraping, notebook editing โ€” each permission-gated and sandboxed.

๐Ÿง 

Query Engine

Central intelligence managing all LLM API calls, response streaming, caching strategies, and multi-step orchestration.

๐Ÿ”Œ

MCP Integration

Full Model Context Protocol support with 6 transport types โ€” Stdio, SSE, HTTP, WebSocket, SDK, and proxy.

๐Ÿ‘ฅ

Multi-Agent Swarms

Spawn sub-agents to parallelize complex tasks in isolated contexts with shared memory access.

๐Ÿ’พ

Session & Memory

Multi-layer memory system with session persistence, transcript compaction, and context discovery.

๐Ÿ”ฎ

Provider Agnostic

Claude, OpenAI, local models โ€” works with any LLM provider. Not locked to a single vendor.

Architecture

Four layers running inside a single Android APK. The embedded Linux environment is extracted from the APK on first launch โ€” no root required, no external dependencies.

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                      Android APK                          โ”‚
โ”‚                                                           โ”‚
โ”‚  WebView (Vue.js)  โ†โ†’  CodexServerManager                 โ”‚
โ”‚                                                           โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
โ”‚  โ”‚  claw-code agent   โ†’ :18923  (HTTP + Vue UI)        โ”‚ โ”‚
โ”‚  โ”‚    โ””โ”€ Rust core    (aarch64-musl, JSON-RPC)          โ”‚ โ”‚
โ”‚  โ”‚                                                      โ”‚ โ”‚
โ”‚  โ”‚  agent gateway     โ†’ :18789  (WebSocket)             โ”‚ โ”‚
โ”‚  โ”‚  control UI        โ†’ :19001  (Static files)          โ”‚ โ”‚
โ”‚  โ”‚                                                      โ”‚ โ”‚
โ”‚  โ”‚  proxy.js          โ†’ :18924  (CONNECT, DNS/TLS)      โ”‚ โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Services

PortServicePurpose
18789GatewayWebSocket control plane for agents, sessions, tools
18923Web ServerHTTP server with Vue.js UI (WebView target)
18924CONNECT ProxyDNS/TLS bridge for musl-linked Rust binary
19001Control UIStatic file server for agent dashboard

How it works

Embedded Linux โ€” The APK bundles Termux's bootstrap-aarch64.zip, a minimal Linux userland with sh, apt, SSL certs, and core libraries. Extracted to the app's private storage on first launch. No root required.

Native Rust Binary โ€” A 73MB native Rust binary compiled for aarch64-unknown-linux-musl. Downloaded from the npm registry and extracted manually because npm refuses to install it on Android.

DNS/TLS Proxy โ€” The musl-linked binary reads /etc/resolv.conf for DNS, which doesn't exist on Android. A Node.js CONNECT proxy bridges this gap using Android's Bionic DNS resolver.

Android Compatibility โ€” The bionic-compat.js shim patches process.platform to return "linux", fixes os.cpus() and os.networkInterfaces() for Android's non-standard formats.

W^X Bypass โ€” Android 10+ enforces SELinux W^X policies. Uses targetSdk = 28 to bypass this โ€” same approach as Termux (F-Droid).

Boot sequence

From cold start to a fully operational AI coding agent in your WebView.

Battery & Service

Request Doze exemption. Start foreground service with persistent notification.

Bootstrap Extraction

Extract Termux bootstrap zip into app's private storage. Full Linux userland, unpacked.

Runtime Installation

Install Node.js 24, Python, clang/cmake/make/lld for native module builds.

Agent Framework

Install Claw Code agent + native Rust binary. Build native FFI modules from source.

Proxy & Auth

Start CONNECT proxy for DNS/TLS bridging. OAuth login via browser. One-time setup.

Launch

Start gateway, Control UI server, web server. WebView loads and you're coding.

Mobile vs. Desktop

Same agent framework, different platform. Here's how the mobile experience compares to running Claw Code on a desktop or server.

AspectDesktop (Mac / Linux / Cloud)Mobile (This App)
PlatformmacOS, Linux, WSLAndroid 7.0+ (ARM64)
Installationpip install + terminal setupDownload APK โ†’ Open โ†’ Done
DependenciesPython, Rust, Node.jsNothing. Zero. Nada.
LinuxNative OSEmbedded in APK
Server Cost$0โ€“โˆž (cloud VMs)$0. It's your phone.
PortabilityCarry your laptopCarry your pocket
BackgroundTerminal stays openForeground service
Agent Features19 tools, 15 commands, MCP19 tools, 15 commands, MCP

Quick start

Download the APK and go, or build from source if you prefer.

Easiest option

Just download the APK or get it from Google Play. Open. Login. Code.

# Clone git clone https://github.com/friuns2/claw-code-android.git cd claw-code-android # Build frontend npm install && npm run build # Prepare Android cd android && bash scripts/download-bootstrap.sh # Build, install, launch bash scripts/build-server-bundle.sh && ./gradlew assembleDebug \ && adb install -r app/build/outputs/apk/debug/app-debug.apk \ && adb shell am start -n com.codex.mobile/.MainActivity

Tech stack

LayerTechnologyDetails
Agent FrameworkClaw CodePython + Rust clean-room rewrite
Rust Core6-crate workspace16 runtime modules, zero-dep JSON parser
Tool System19 built-in toolsPermission-gated, sandboxed
Commands15 slash commands/compact, /model, /session, /cost, etc.
LLM SupportProvider-agnosticClaude, OpenAI, local models
RuntimeNode.js 24Via Termux package manager
FrontendVue.js 3 + Vite + TailwindServed via embedded HTTP server
AndroidKotlin + WebViewForeground service, OAuth, battery exemption
LinuxTermux bootstrapaarch64, extracted from APK at first launch

Requirements

Latest upstream release

Release notes are synced automatically from the upstream Claw Code repository when available.

All Upstream Releases