Poki

What it does

• Drives a real iPhone over a local native bridge — no jailbreak
• Poki MCP: one claude mcp add line registers it into Claude Code; Codex and any mcpServers-JSON client also work, on your own subscription
• Optional standalone Poki Agent defaults to GPT-6.1 Terra at low reasoning (POKI_AGENT_MODEL to override) and adds iMessage and Telegram channels
• Prebuilt macOS arm64 package bundles the native bridge and idevice tools — skips the Rust build, keeps the Xcode/Node 24+/Python 3/ffmpeg requirements
• Multi-device aware: list device UUIDs and target one with --device

When to use it

For handing repetitive on-phone work to an agent: search and summarize in Chrome, organize screenshots, draft and send messages — whenever you want Claude Code tapping, swiping and typing on a real iPhone.

Getting started

# MCP route (Claude Code): build, start the server, register it
git clone https://github.com/JosssphZhou/poki.git && cd poki
./bin/setup        # checks macOS 15+, full Xcode, Rust, Node 24+, ffmpeg
npm start
claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"

# or the prebuilt arm64 package (no Rust, no ./bin/setup): download poki-v0.1.1-macos-arm64.tar.gz
# from releases, tar -xzf, cd poki-v0.1.1, npm ci --no-audit --no-fund, npm start — then register as above

# optional standalone agent (separate terminal, server still running):
npm ci --prefix agent
export PATH="$PWD/bin:$PATH"
poki login

Things to know

It controls your real phone: ask it to send messages or make payments and it will — and screen contents go to your configured model service (the README states both up front). Physical-iPhone support is verified only on phones running the Chinese interface, portrait orientation only; app container export and direct links to Settings subpages are unavailable. The bundled agent's default model is GPT-6.1 Terra, an OpenAI model — the MCP route keeps the model choice with your client instead. AGPL-3.0-only. 400 stars as of writing (2026-11-07).