Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Poki uses your iPhone like you do. An agent that taps, types and swipes on your real iPhone.

Copy this prompt and send it to your coding agent

Install Poki on my iPhone from https://github.com/JosssphZhou/poki

Connect your iPhone over USB and unlock it first. A free Apple Account works.

GitHub stars Poki App 0.4.4 Beta Platform: iOS, macOS and Windows License: AGPL-3.0-only

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español
poki.bot

If Poki is useful to you, click ★ Star to support the project.

What Poki is

Poki is an open-source iPhone agent that operates your entire iPhone for you. The Poki app runs directly on your iPhone, reads the screen, and taps, types, and scrolls inside real apps using your own model account. You choose how it asks for permission; payments, deletions, and Wallet actions always stop for your confirmation.

Poki orders on Uber Eats by itself

Why Poki

Poki's step-by-step plan for ordering beef noodle soup, shown in chat Poki in the Dynamic Island while it works in another app Poki asking for approval before a payment: Allow payment?

  • Skip multi-app tapping for everyday errands. Ask Poki in chat, hold the Action Button, or trigger Siri to look things up in the built-in browser, check tomorrow's weather, or create a note. On iPhone Duo, Poki works across two apps side by side in Split View.
  • Run saved skills by tap or by voice. Launch a saved skill from the home screen instead of repeating the same steps every day, or start a hands-free spoken chat with Talk to Poki while Dynamic Island tracks each step.
  • Automate your real phone without keeping a computer on. Once installed from a Mac or Windows PC, Poki runs standalone on your iPhone with no computer attached and pauses on the Lock Screen or in Dynamic Island whenever a step needs approval.

How to use

Install Poki on your iPhone

  1. Install once from a Mac or Windows PC. Connect and unlock your iPhone over USB (a free Apple Account works), then tell your coding agent, such as Claude Code or Codex:

    Install Poki on my iPhone from https://github.com/JosssphZhou/poki

    Or download Poki Setup for macOS (.dmg) or Windows (.exe) and follow the window.

  2. Connect and add your model account. Accept Trust, turn on Developer Mode and Automation Mode when iOS asks, set up an external connection routing 10.7.0.1 back to your iPhone (such as free LocalDevVPN), and sign in with ChatGPT Plus or Pro or paste an API key (Anthropic, OpenAI, Gemini, DeepSeek, OpenRouter, OpenCode Go, or an OpenAI-compatible server).

  3. Run your first task. Open Poki and send:

    Create a new note in Notes titled "Poki Demo" with these three lines: Milk, Eggs, Coffee. Open the note when finished. Leave existing notes unchanged.

    Open Notes afterward to confirm "Poki Demo" exists with those three lines.

Requirements, updating, common questions, and guides
Requirement
iPhoneiOS 18 or later (iPhone XS, XR, SE 2nd gen or newer; iPadOS 18+ on iPad). Tested on physical iPhones with iOS 27.
ComputerMac with macOS 14+ (Node.js 24+ for agent install) or Windows PC (x64) with Apple Devices or iTunes.
Cable and accountUSB data cable and an Apple Account. Poki Setup renews free 7-day signatures while open, or sign in inside Poki.
ConnectionExternal connection routing 10.7.0.1 back to the iPhone (LocalDevVPN, Karing, or Shadowrocket).
Model accountChatGPT Plus/Pro sign-in, an API key (Anthropic, OpenAI, Gemini, DeepSeek, OpenRouter, OpenCode Go), or an OpenAI-compatible server.

Community

See all contributors in CONTRIBUTING.md.


Poki

Copyright (c) 2026 Joseph Zhou (周瑟夫) and contributors. Open source under AGPL-3.0-only. Brand assets are governed by BRAND.md. See Poki iPhone App Guide, THIRD_PARTY_NOTICES.md, and Disclaimer.

关于 About

Poki uses your iPhone like you do. An open-source agent app that runs on your iPhone, reads the screen, and taps, types and swipes in real apps with your own model account.
ai-agentsai-assistantautomationclaude-codecomputer-usegui-agentiosios-appiphonellmmcpmobile-agentmodel-context-protocolopen-sourcephone-agentswiftvoice-assistant

语言 Languages

Swift58.0%
JavaScript19.5%
Rust15.9%
Objective-C3.5%
TypeScript1.3%
Shell1.0%
Python0.6%
CSS0.2%
C0.1%
HTML0.0%
Dockerfile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
1753
Total Commits
峰值: 930次/周
Less
More

核心贡献者 Contributors