Skip to content

friuns2/openclaude-android

BranchesTags
 
 

Repository files navigation

🧠 OpenClaude Mobile

🚀 Claude Code on Your Phone — Full Linux, No Server, No PC 🚀

Android OpenClaude Claw Code Python Rust Kotlin Status License


They said Claude Code only runs on Mac and Linux desktops. We put it on a phone. Full agent. Full Linux. Full tools. Zero servers.


 ██████╗ ██████╗ ███████╗███╗   ██╗ ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
██║   ██║██████╔╝█████╗  ██╔██╗ ██║██║     ██║     ███████║██║   ██║██║  ██║█████╗
██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
╚██████╔╝██║     ███████╗██║ ╚████║╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
 ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
          M O B I L E  ·  A I  ·  C O D I N G  ·  A G E N T

Download APK · Google Play · Claw Code Docs · OpenClaude Upstream

🤯 What Is This?

This project puts Claude Code on your Android phone.

Not a wrapper. Not a web app. The actual OpenClaude agent — the community-built open-source coding CLI that originated from the Claude Code architecture — running in a full embedded Linux environment inside an APK.

  • OpenClaude — the open-source coding agent CLI forked from the Claw Code project (itself a clean-room rewrite of Claude Code's architecture). 19 tools, 15 slash commands, MCP integration, multi-agent swarms, provider-agnostic.
  • Runs inside an embedded Linux environment extracted from the APK
  • No root. No Termux dependency. No server. No Mac. No PC. Everything is self-contained.

🧠 TL;DR — Anthropic's Claude Code got leaked. The community rewrote it as Claw Code (48K+ ⭐). It was forked as OpenClaude with multi-provider support. We put it on Android. Full AI coding agent in your pocket.

🦀 The Claude Code Story

In March 2026, Anthropic accidentally leaked 512K lines of Claude Code source via an npm source map. The community built Claw Code — a clean-room rewrite in Python + Rust that hit 48K+ stars in hours. It was later forked as OpenClaude with expanded multi-provider support.

We made it run on Android. The full agent. All the tools. On your phone.

What Description
🧠 OpenClaude Agent Full Claude Code architecture — 19 tools, 15 slash commands, multi-agent swarms
🔧 19 Built-in Tools File I/O, shell execution, Git operations, web scraping, notebook editing — permission-gated
🔌 MCP Integration Model Context Protocol with 6 transport types — connect external tool servers
👥 Multi-Agent Swarms Spawn sub-agents to parallelize tasks in isolated contexts
🔮 Provider Agnostic Claude, OpenAI, Gemini, Ollama, DeepSeek, local models — not locked to Anthropic
⚡ Rust Core 6-crate workspace, 16 runtime modules, native performance
🌐 gRPC Server Run headless as a gRPC service for custom UIs and CI/CD pipelines
💬 15 Slash Commands /compact, /model, /permissions, /cost, /session — full interactive REPL

📱 Screenshots


💬 AI Coding Agent
Full conversational coding with streaming responses and tool execution.
🧩 Multi-Thread Sessions
Parallel conversations, each with its own context and working directory.

🌍 What Can You Do?

Feature Description
🧠 Claude Code Agent Full OpenClaude agent with 19 tools, query engine, multi-agent swarms
🔧 File Operations Read, write, edit files — full codebase manipulation from your phone
💻 Shell Execution Run bash commands in the embedded Linux environment
🔍 Grep & Glob Search your codebase with regex and glob patterns
🌐 Web Search & Fetch Search the web, fetch pages, scrape content
📓 Notebook Editing Edit Jupyter notebooks programmatically
🐙 Git Operations Commit, push, branch, diff — full Git workflow
🔌 MCP Servers Connect external tool servers via Model Context Protocol
👥 Agent Swarms Spawn sub-agents for parallel task execution
🔮 Any LLM Provider OpenAI, Claude, Gemini, Ollama, DeepSeek, OpenRouter, local models
🧵 Multi-Thread Parallel sessions, each with isolated context
📴 Offline Bootstrap Linux environment from APK — works offline after setup

⚡ Quick Start

Option 1: Download APK

Download the latest APK or get it from Google Play.

Option 2: Build from Source

# 🔽 Clone
git clone https://github.com/friuns2/openclaude-android.git
cd openclaude-android

# 🔧 Install deps
bun install

# 🏗️ Build
bun run build

# 🚀 Run
node dist/cli.mjs

Option 3: Termux on Android

See ANDROID_INSTALL.md for the full Termux + proot Ubuntu setup guide.

🏗️ Architecture

┌──────────────────────────────────────────────────────────┐
│                    Android Device                         │
│                                                           │
│  ┌──────────────────────────────────────────────────────┐ │
│  │             Embedded Linux ($PREFIX)                   │ │
│  │                                                       │ │
│  │  ┌─────────────────────────────────────────────────┐  │ │
│  │  │           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         │ │
│  │  Node.js 22   → Bun runtime + dependencies           │ │
│  │  Python 3.10  → agent orchestration layer             │ │
│  │  Git, rg, fd  → dev toolchain                         │ │
│  │                                                       │ │
│  │  gRPC Server  → :50051 (headless mode)                │ │
│  └──────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘

🔮 Supported Providers

OpenClaude is provider-agnostic. Point it at any LLM:

Provider Setup Notes
🤖 OpenAI /provider or env vars GPT-4o, GPT-4.5, o3
🧠 Claude /provider or env vars Claude 4 Opus, Sonnet, Haiku
💎 Gemini /provider or env vars API key, access token, or ADC
🦙 Ollama /provider or env vars Local inference, no API key
🌐 OpenRouter /provider or env vars 100+ models, one API
🐋 DeepSeek /provider or env vars DeepSeek V3, Coder
🐙 GitHub Models /onboard-github Interactive onboarding
⚛️ Codex /provider Existing Codex credentials
🍎 Atomic Chat Advanced setup Local Apple Silicon
☁️ Bedrock/Vertex env vars AWS/GCP provider integrations

🔥 How It Works

🐧 Embedded Linux

The app extracts a Termux-derived Linux userland into app-private storage. You get sh, apt, Node.js, Python, SSL certs — a complete development environment.

🦀 Rust Performance Core

6-crate Rust workspace with 16 runtime modules. Zero-dependency JSON parser, OAuth PKCE flow, syntax-highlighted terminal rendering. Performance-critical paths run at native speed.

🧠 Query Engine

The central intelligence — manages all LLM API calls, response streaming, caching strategies, and multi-step orchestration. Provider-agnostic design with configurable turn limits and budget controls.

🔧 Tool System

19 built-in, permission-gated tools. Each capability — file reading, bash execution, web scraping, LSP integration, Git operations — is a self-contained plugin with granular permission controls.

🔌 MCP Integration

Full Model Context Protocol support with 6 transport types — Stdio, SSE, HTTP, WebSocket, SDK, and ClaudeAiProxy. Connect external tool servers with automatic name normalization and OAuth.

🔓 W^X Bypass

Android 10+ enforces SELinux W^X policies. We use targetSdk = 28 to bypass this, same approach as Termux (F-Droid).

💬 Slash Commands

Command What it does
/model Switch LLM provider/model on the fly
/provider Guided provider setup with saved profiles
/compact Compress conversation context
/cost Show token usage and cost estimates
/session Manage sessions, resume previous work
/permissions Configure tool access policies
/onboard-github GitHub Models interactive onboarding
/help Full command reference

Plus 7 more slash commands for agents, tasks, exports, and debugging.

📁 Project Structure

src/                              # Core CLI / runtime
├── commands.py                   # 🎯 CLI command registry & dispatch
├── tools.py                      # 🔧 Plugin-based tool system (~40 tools)
├── models.py                     # 🔮 LLM provider abstraction layer
├── query_engine.py               # 🧠 Core query engine
├── task.py                       # 📋 Task management & agent lifecycle
└── main.py                       # 🚀 Entry point
rust/                             # 🦀 Rust core (performance-critical)
python/                           # 🐍 Python helpers and tests
scripts/                          # 🔧 Build, verification, maintenance
docs/                             # 📖 Setup guides
vscode-extension/                 # 🔌 VS Code extension
bin/                              # 🚀 CLI launcher entrypoints

🎯 Requirements

  • 📱 Android 7.0+ (API 24) — ARM64 device
  • 🌐 Internet connection — for first-run setup + API calls
  • 🔑 LLM API key — any supported provider (OpenAI, Claude, Gemini, Ollama, etc.)
  • 💾 ~700MB storage — for Linux environment + Bun + OpenClaude + dependencies

🧬 Tech Stack

Layer Technology Version
🧠 AI Agent OpenClaude (Claude Code architecture) latest
🦀 Performance Rust core (6 crates, 16 modules) —
🐍 Orchestration Python agent layer 3.10+
⚙️ Runtime Bun (via proot Ubuntu) 1.3+
🔮 LLM Support Provider-agnostic (10+ providers) —
🔌 Protocol MCP (6 transport types) —
📱 Android Kotlin + WebView 2.1.0
🐧 Linux Termux bootstrap (aarch64) —

🐛 Troubleshooting

Problem Solution
App crashes on launch Check adb logcat for errors
"Permission denied" executing binaries Ensure targetSdk = 28 in build.gradle.kts
Bun won't install Use proot Ubuntu — Bun doesn't support Android natively
"ripgrep not found" Install rg system-wide: apt install ripgrep
Provider connection fails Check API key and /provider config
App killed in background Grant battery optimization exemption in settings

🤝 Agent Routing

Route different agents to different models for cost optimization:

{
  "agentModels": {
    "deepseek-chat": {
      "base_url": "https://api.deepseek.com/v1",
      "api_key": "sk-your-key"
    },
    "gpt-4o": {
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-your-key"
    }
  },
  "agentRouting": {
    "Explore": "deepseek-chat",
    "Plan": "gpt-4o",
    "default": "gpt-4o"
  }
}

📜 Credits

  • 🧠 OpenClaude — Open-source coding agent CLI, forked from Claw Code
  • 🦀 Claw Code — Clean-room rewrite of Claude Code architecture (48K+ ⭐)
  • 🌐 Claw Code Website — Architecture docs, tool system, comparisons
  • 📱 AnyClaw — The Android runtime that makes this possible
  • 🐧 Termux — Linux environment bootstrap for Android
  • 🔬 Sigrid Jin — Creator of the original Claw Code clean-room rewrite

Claude Code. On a phone. In your pocket. 🔬 They leaked the source. We put it on Android. You're welcome. 😏

Download APK · Google Play · Claw Code Docs · OpenClaude Upstream

About

🧠 OpenClaude Mobile — Claude Code on Android. Full AI coding agent in your pocket. 19 tools, MCP, multi-agent swarms, 10+ LLM providers. No server. No PC.

friuns2.github.io/openclaude-android/

Topics

android kotlin python rust mobile mcp openai claude linux-on-android anthropic ollama claude-code ai-coding-agent openclaude claw-code

Resources

Readme

License

View license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

4 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.4%
  • Other 0.6%