PhoneClaw

Turn your phone into a local AI agent runtime.

Website · TestFlight · 中文 · Report an Issue · Request a Feature

Core Features · Built-in Skills · Technical Notes · Quick Start · Mac Remote · Custom Skills · FAQ · Roadmap

PhoneClaw is a local AI agent framework for phones and edge devices. It runs Gemma 4 E2B / E4B via LiteRT and MiniCPM-V 4.6 on device, uses native mobile Skills for Calendar, Reminders, Contacts, Clipboard, Health data, image understanding, voice, and LiveLand, and lets you explicitly choose Web Search, webpage reading, or LAN-based Mac Gateway inference when a task needs it.

PhoneClaw (this project) is unrelated to the Android automation repo "rohanarun/phoneclaw" or the "phoneclaw" GitHub organization. Android app-store search results may also show a separate app with the same name.

Demo

Latest Updates

2026-06-23

• Added LiveLand: use PhoneClaw from Dynamic Island. The local AI listens, understands your request, runs the task, and shows the result right there
• Launch LiveLand from Home Screen widgets, Lock Screen widgets, Shortcuts, Control Center widgets, or inside the app. It also works on non-iOS 27 systems
• Task progress is easier to follow: PhoneClaw now shows when it received your command, is understanding it, is querying or executing, is preparing the result, and is done
• More natural phone tasks: ask for health data, create reminders, schedule calendar events, find contacts, translate text, and more through natural language
• Fixed a LiveLand widget launch issue that could incorrectly show "download model first" or "model loading" even after the model was already installed
• Safer actions: unclear times, titles, contacts, deletes, and bulk operations ask for clarification or confirmation before running
• LiveLand runs on local models by default, with a fully offline local path and local execution free of per-call token billing
• TestFlight link: https://testflight.apple.com/join/YuUSwq78

2026-06-08

• Added the PhoneClaw Gateway Mac client: keep it running on your Mac, advertise it over Bonjour, then pair from the iPhone to use Mac-side Ollama, Codex CLI, or Antigravity CLI as a remote inference source
• Added a Mac Remote page in iPhone settings: discover Macs on the same LAN, approve pairing on the Mac, choose a Mac-side model, then use it from the normal chat screen
• Remote models are only used after you explicitly pair a Mac and select one. With Ollama, inference stays on your Mac; with CLI or other upstream providers, data handling follows that provider's behavior
• How to use: download PhoneClawGateway-macOS-v0.1.1.zip, unzip it, open PhoneClawGateway.app, allow Local Network permission, then pair from Mac Remote on the iPhone; see Use the Mac client for remote inference

2026-06-05

• PhoneClaw is live on TestFlight — Join TestFlight
• Rebuilt the overall Agent framework: improved Skill result semantics, Skill routing, tool-call chains, contextual follow-ups, and multi-step task handling, so the model can more reliably choose whether to answer directly, call tools, or continue from the previous result while reducing accidental tool triggers, repeated calls, and off-track follow-ups
• Added Health range reports: summarize steps, distance, active energy, heart rate, sleep, workouts, weight, and HRV across a selected time range, then generate a local health summary, trends, and key metric explanations

2026-06-01

• PhoneClaw is live on TestFlight — Join TestFlight
• Added Calendar read support: query today's, tomorrow's, this week's, and next 7 days' schedule, with busyness and free-time analysis
• Improved Web Search and long-answer browsing: realtime information can be summarized, and history remains scrollable while the model is responding

2026-05-17

• PhoneClaw is live on TestFlight — Join TestFlight
• A private local Agent running on iPhone, performing inference and Skill calls entirely on-device with a fully offline local path

2026-05-12

• Released v1.4.0 — Download
• Added MiniCPM-V 4.6 multimodal model — image Q&A and real-time camera recognition in LIVE mode
• Fixed several known issues in LIVE mode

2026-05-07

• Added MTP speculative decoding toggle (experimental — only speeds up Gemma 4 E4B with short replies).

2026-04-25

• Released v1.3.1 — Download
• Added English LIVE mode
• Fixed some known bugs
• Released v1.3.0 — Download
• Added English localization — the app automatically switches based on system language.
• Refactored the download module: resumable downloads, background downloads, and automatic fastest-mirror selection based on current network conditions.

2026-04-23

• Released v1.2.2 — added the ability to choose between GPU or CPU inference backend directly from the settings page; CPU is now the default to fit within Sideloadly-signed memory limits.
• ⚠️ Sideloadly-signed IPA usage note: due to the memory cap of sideload-signing, the E4B model only works on CPU (GPU will fail). We recommend using the E2B model — it's fully featured and more stable under the cap.
• 💡 If you can, build from source with Xcode: Xcode-signed builds aren't subject to the sideload memory cap — you can run E2B / E4B with GPU enabled for best performance. Download

2026-04-20

• Released an unsigned IPA — sign and install to iPhone via Sideloadly. Download

2026-04-18

• Added in-app download for LIVE mode voice models — download directly from the settings page and start using LIVE mode

2026-04-17

• Added LIVE Mode: a new real-time voice interaction mode with natural conversation flow and barge-in interruption
• LIVE Mode supports camera input: the model can recognize and understand the environment, objects, and scenes captured by the camera in real time, enabling multimodal "see and speak" interaction

2026-04-10

• Added Health Skill: read HealthKit data including today's/yesterday's steps, weekly step trends, walking distance, active calories, resting heart rate, last night's sleep, weekly sleep summary, and recent workouts — 9 tools total, all data processed locally
• Improved multi-turn response speed: cross-turn KV cache reuse reduces time-to-first-token by ~3.5x for consecutive queries within the same skill
• The 9 health tools are automatically selected by the model based on user intent

2026-04-09

• Ongoing framework and infrastructure work. Major improvement to the multi-turn agent framework: the Router now correctly preserves skill context across turns, and even small models can reliably complete multi-turn tool calls.

2026-04-08

• Model downloads now include a ModelScope mirror for faster Gemma 4 downloads in mainland China
• Major rework of memory management: the inference budget is now dynamically derived from actual available memory, with improved long prompt, long answer, and multi-turn tool-call context handling

2026-04-07

• Added voice input, with on-device audio analysis and recognition
• Added Thinking Mode, available from the top-right corner in chat
• Added chat history, with support for new sessions, switching, and deletion
• Improved memory management and inference budgeting for long answers, multimodal requests, and model switching

2026-04-06

• The default install flow is back to a shell app, with models downloaded on-device as needed
• The settings page now includes model download, permission status, and bilingual display names
• Contacts, reminders, calendar, device info, and clipboard flows have received a round of stability fixes

Core Features

Private Local Agent: Run inference and Skill calls directly on device. Use natural language to work with Calendar, Reminders, Contacts, Clipboard, Health data, and other local tasks.

Mac Remote Inference: Optionally pair with a Mac on the same LAN through PhoneClaw Gateway and use Mac-side Ollama, Codex CLI, or Antigravity CLI models while keeping the native iPhone chat and Skill experience.

Image Understanding and LIVE Vision: Ask questions about photos from the camera or photo picker, or enable the camera in LIVE mode so the model can understand the scene in