Poki: an open-source agent that operates your iPhone
A Swift project that reads the screen and controls real iOS apps locally has picked up 1,432 stars in 11 days.
A phone agent that lives on the phone
An open-source iPhone AI agent called Poki is getting attention on GitHub. The repository, JosssphZhou/poki, was created on 2026-11-05 and had 1,432 stars and 231 forks by 2026-11-16, according to the project's repository page. It is written mainly in Swift and released under AGPL-3.0, and its listed topics include ai-agents, automation, ios, iphone and model-context-protocol.
The pitch is literal: Poki reads what is on the screen and then taps, types and scrolls inside real apps on a physical iPhone. You give it a task in a chat field and it works in your other apps while you watch.
What the source confirms
The app runs on the iPhone itself. You install it once from a Mac or a Windows PC, and after that it runs tasks without the computer attached. Each step is shown in the Dynamic Island and on the Lock Screen, and tasks can also be started without opening the app, through a long press on the Action Button or through Shortcuts and Siri.
Approval behaviour is configurable. In Settings > Approvals you decide how Poki asks before sensitive steps such as sending a message or typing a password, or whether it asks at all. Payments, deletions and actions in Wallet always require confirmation, according to the README.
Control works differently depending on the OS version. On iOS 27 and later Poki uses native services. On iOS 18 to 26 it uses an XCTest session instead, which requires UI Automation to be switched on in the iPhone's Developer settings.
For coding agents, the project ships an MCP route: Poki plugs into Claude Code and other MCP clients, and in that mode it uses the client's model access rather than a separate account.
Setup is the hard part
Requirements are specific. The iPhone needs iOS 18 or later, meaning iPhone XS, XR, SE (2nd generation) or newer, and the app also installs on iPad with iPadOS 18 or later. The computer must be a Mac on macOS 14 or later, or a Windows x64 PC with Apple Devices or iTunes installed. An agent-driven install on a Mac also needs Node.js 24 or later. You need a USB data cable and an Apple Account.
A free Apple Account works, but Apple signs apps from it for 7 days only. While Poki Setup stays open on the computer, it renews the signature every 6 hours once 2 days or fewer remain. Without a renewal, Poki stops opening when the signature ends and warns during the last 2 days.
A VPN app on the iPhone is also required, one that routes 10.7.0.1 back to the iPhone. The README names the free LocalDevVPN from the App Store, plus Karing and Shadowrocket configured through Poki's instructions.
You bring your own model account. The README calls signing in with a ChatGPT Plus or Pro plan the easiest start. Alternatively you can paste an API key from Anthropic, OpenAI, Gemini, DeepSeek or OpenRouter, or point it at your own OpenAI-compatible server. A Claude subscription cannot sign in, so an Anthropic API key is the suggested substitute. Voice conversations need a voice model key as well.
Limits and open questions
The README is unusually candid about what has not been tested. Physical iPhone support has been verified only on devices set to the Chinese interface, in portrait orientation, and landscape is not supported. The release has not been tested on a physical iPhone below iOS 27 or on an iPad, and the iOS 18 to 26 control path has not been tested on a physical device yet.
The privacy model is worth reading twice: screen contents are sent to whichever model service you configure, and the app will carry out what you ask, including sending messages. Reading releases from GitHub can fail with 403 or 429 errors when many people share a network. Deleting the app also deletes its conversations, so the README advises against deleting it to fix a stuck update.
The installer currently selects the Beta channel, and older Stable, Alpha and Pre-alpha preferences also resolve to Beta. The roadmap lists more verified devices, more screen languages and more model providers as planned work, without dates. How reliable the agent is across long, multi-app tasks is not documented in the source.
What this suggests for builders
The interesting design choice here is not the tapping. It is the packaging: an on-device agent with an MCP interface, so an existing coding agent can drive a phone the same way it drives a terminal. This suggests more tools will ship as MCP servers rather than as standalone apps, with the model account kept separate from the tool itself.
If you are building the other side of that equation, an app with its own AI features, the same question applies: which model does the work, and whose account pays for it. Draftship's documentation on adding AI to your app covers that layer. Draftship is not affiliated with Poki and does not support it.
Primary sources
This article was drafted with AI assistance from the primary sources listed below and checked automatically against them. An editor hasn't reviewed it yet.