In action
Claude Code, on a phone
Claude Code · On Android · No Server
The open-source Claude Code agent running natively on your Android phone. Full Linux environment, 19 tools, multi-agent swarms, MCP integration — provider-agnostic. No root. No server. No PC.
In action
Origin
In March 2026, Anthropic accidentally published 512K lines of Claude Code source via an npm source map. The community rebuilt it as Claw Code (48K+ ★), then forked it as OpenClaude with multi-provider support. We put it on Android.
Capabilities
OpenClaude Mobile brings the complete Claude Code agent architecture to Android — 19 built-in tools, multi-agent swarms, MCP integration, and support for 10+ LLM providers. All running in an embedded Linux environment.
Full OpenClaude agent — 19 tools, query engine, session memory, transcript compaction. The real thing.
File I/O, bash execution, grep, glob, Git operations, web search, notebook editing — all permission-gated.
Spawn sub-agents for parallel tasks. Decompose complex work into independently executable subtasks.
Model Context Protocol with 6 transport types — Stdio, SSE, HTTP, WebSocket, SDK, ClaudeAiProxy.
Claude, OpenAI, Gemini, Ollama, DeepSeek, OpenRouter, GitHub Models — not locked to any vendor.
Complete Termux-derived userland — sh, apt, Bun, Node.js, Python, SSL certs. Extracted from APK.
Any model
OpenClaude is provider-agnostic. Use the /provider
command or environment variables to switch models on the fly.
Under the hood
┌────────────────────────────────────────────────────────┐ │ Android Device │ │ │ │ ┌──────────────────────────────────────────────────┐ │ │ │ OpenClaude Agent │ │ │ │ │ │ │ │ Query Engine → LLM API (streaming, caching) │ │ │ │ Tool System → 19 built-in tools │ │ │ │ MCP Client → 6 transport types │ │ │ │ Agent Swarms → parallel sub-agents │ │ │ │ Session Mgr → persistence, compaction │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ Rust Core → 6 crates, 16 runtime modules │ │ Bun / Node → runtime + dependencies │ │ Python 3.10 → agent orchestration │ │ Git, rg, fd → dev toolchain │ └────────────────────────────────────────────────────────┘
Boot sequence
Request Doze exemption. Start foreground service with persistent notification.
Extract Termux bootstrap into app’s private storage. Fix hardcoded paths.
Install Bun, Node.js, Python, ripgrep, and build dependencies via proot Ubuntu.
Install OpenClaude globally. Build Rust core. Configure tool permissions.
Run /provider for guided setup or set env vars for your LLM.
Full agent loop active. 19 tools loaded. MCP connected. Start coding from your phone.
Get started
# option 1: npm install
npm install -g @gitlawb/openclaude
openclaude
# option 2: build from source
git clone https://github.com/friuns2/openclaude-android.git
cd openclaude-android
bun install && bun run build
node dist/cli.mjs
# option 3: just download the APK
# → https://friuns2.github.io/openclaude-android/
Or download the latest APK directly, or get it from Google Play. For Termux setup, see ANDROID_INSTALL.md.
Stack
| Layer | Technology | Details |
|---|---|---|
| 🧠 AI Agent | OpenClaude (Claude Code architecture) | 19 tools, query engine, swarms |
| 🦀 Performance | Rust core (6 crates, 16 modules) | JSON parser, OAuth, terminal |
| 🐍 Orchestration | Python agent layer | 3.10+ |
| ⚙️ Runtime | Bun + Node.js | 1.3+ / 22+ |
| 🔮 LLM Providers | Provider-agnostic (10+) | Claude, OpenAI, Gemini, Ollama… |
| 🔌 Protocol | MCP (6 transport types) | Stdio, SSE, HTTP, WS, SDK |
| 📱 Android | Kotlin + WebView | 2.1.0 |
| 🐧 Linux | Termux bootstrap (aarch64) | — |
Latest upstream release
Synced from Gitlawb/openclaude
Release notes will appear here automatically when upstream publishes a release.