What it does
Control any app on a real iPhone (iOS 27+) via accessibility tree. No Xcode or WebDriverAgent.
- Connects 내 컴퓨터에서 실행
- Account or key No key needed
- Category 개발자 도구
함께 쓰기
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
이 순위인 이유
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 24/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 36/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 3/3 통과 · 내 컴퓨터에서 실행돼요
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude는 아직 iphone-cli (iph)에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
ChatGPT는 아직 iphone-cli (iph)에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
대신 이렇게 할 수 있어요
B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code는 아직 iphone-cli (iph)에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
Cursor는 아직 iphone-cli (iph)에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
VS Code는 아직 iphone-cli (iph)에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
한눈에 보기
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 HyunSeob 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 오늘
- ✓ 통과
라이선스 있음
MIT 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/hyunseob-iphone-cli)토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 6182개 중 97%보다 스타가 많아요
- 이 카테고리의 다른 서버 6182개 중 99%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 6182개 중 99%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
iphone-cli (iph), 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(0.1.8)은 오늘 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Rust도 있어야 해요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
비슷하게 동작하는 다른 것
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 이 항목 iphone-cli (iph) | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 라이선스 | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
iphone-cli (iph)
Let AI agents read and operate any app on a real iPhone — straight from your terminal.
No Xcode. No WebDriverAgent. No app installed on the phone. 100% Rust.
- Direct Apple developer services — connects over USB or Wi-Fi to the same accessibility and HID services Xcode uses, with no signing or test runner
- Accessibility tree, not screenshots — reads structured UI elements cleanly, and runs multi-step flows in one call with a built-in QuickJS engine (
iph script) - Agent-ready — CLI + MCP server (
iph mcp) + safety-first outcomes (done/not_sent/unknown) - Single native binary (macOS & Windows) — no Python, Node.js, or Appium runtime; install one binary and target a real iPhone on iOS 27+
Website · llms.txt · crates.io · 한국어
Built on the principle of Poki (a new implementation from its documented behaviour and device experiments, with no Poki code). Device communication relies on idevice (MIT).
$ iph read --human
Settings 430x932 15 elements application "Settings" @0,0 430x932 header "Settings" @20,119.3 53.7x37 switch "Airplane Mode" = "0" @20,489.3 390x49.3 button "Wi-Fi, HomeNet" @20,538.7 390x49.3 button "General" @20,700 390x49.3 …
$ iph tap "General" {"ok":true,"outcome":"done","elapsed_ms":1752,"sent":true,"verified":true,"screen_changed":true,…}
Scope
| Host | macOS, Windows 10/11 (x64) |
| Device | A real iPhone, iOS 27 or later (verified on one iPhone 15 Pro Max with iOS 27.0.1 only, Korean interface). Touch and text input go through the phone's screen-sharing service (com.apple.coredevice.displayservice, new in iOS 27), so input is not expected to work on iOS 26 or earlier (not tried) |
| Connection | USB or the same LAN (the computer may use Ethernet; verified over USB and Wi-Fi on Windows) |
| Out of scope | Simulators, Android, Linux hosts, landscape |
On Windows, doctor, reading, touch and scripts were checked with one iPhone19,4 on iOS 27.2 over USB.
Comparison with alternatives
| Capability | iphone-cli (iph) | iPhone Mirroring + OCR tools | Appium / WebDriverAgent | mobile-mcp |
|---|---|---|---|---|
| Native Accessibility Tree | Yes (structured JSON) | No (screenshots / Vision OCR) | Yes | Partial (WDA on real iOS) |
| No Xcode / No code signing | Yes | Yes | No (requires Xcode & signing) | No (WDA signing on real iOS) |
| No app installed on iPhone | Yes | Yes | No (installs WDA runner) | No (installs WDA on real iOS) |
| Windows host support | Yes (macOS & Windows) | No (macOS 15+ only) | Limited (needs macOS to build WDA) | Limited on real iOS |
| Works in the EU | Yes (no Mirroring needed) | No (Mirroring unavailable) | Yes | Yes |
| Unicode / clipboard text input | Yes (paste + restore) | Simulated keystrokes | Yes | Varies |
| Built-in multi-step scripting | Yes (embedded QuickJS) | External / per-turn calls | External SDK | Per-turn MCP calls |
| Safety outcome contract | `done` / `not_sent` / `unknown` | Varies | Standard exceptions | Standard tool errors |
| Target scope | Real iPhone, iOS 27+ | Real iPhone, iOS 18+ (macOS 15+) | Real iOS & Simulators | Simulators, Android, WDA iOS |
- Choose `iphone-cli` (`iph`) when you want Claude Code, Codex, or another AI agent to operate a real iPhone (iOS 27+) via the accessibility tree without Xcode or WebDriverAgent — including on Windows or in the EU.
- Choose an iPhone Mirroring + OCR tool if your phone runs iOS 18–26 on macOS 15+ outside the EU.
- Choose Appium / WebDriverAgent or `mobile-mcp` if you need iOS Simulators, Android, or iOS 26 and earlier with an element tree.
Install
Neither Rust nor Xcode is needed. On a Mac it is one line in Terminal (it uses only tools macOS ships: curl, tar, shasum).
curl -fsSL https://raw.githubusercontent.com/HyunSeob/iphone-cli/main/install.sh | sh
iph setup # walks through what the phone needs
It downloads the universal binary (Apple silicon and Intel) from the latest release, checks its checksum and puts it at ~/.local/bin/iph. IPH_INSTALL_DIR picks another folder and IPH_VERSION=v0.1.0 a specific version. On Windows, download iph-windows-x86_64.zip from the releases and put iph.exe in a folder on your PATH.
- Mac: plug the phone in and tap Trust on it; that pairs it.
- Windows: Apple's device service must be installed: the Apple Devices app from the Microsoft Store, or just the service with
winget install Apple.AppleMobileDeviceSupport. Then plug the phone in and tap Trust. - Developer disk image: when the phone lacks it,
iph doctorinstalls it. It uses Xcode's copy when the Mac has one, and otherwise fetches one once from the public doronz88/DeveloperDiskImage repository (about 18 MB, pinned commit and SHA-256). The iph repository contains no Apple files.
With Rust 1.88 or later, the crate on crates.io installs the same iph (building it takes a few minutes; on Windows it needs Visual Studio Build Tools (C++)):
cargo install iphone-cli # ~/.cargo/bin/iph
Or from a checkout:
git clone https://github.com/HyunSeob/iphone-cli
cd iphone-cli cargo install --path . # ~/.cargo/bin/iph
First-time setup
iph setup runs iph doctor, says in one line what to do on the phone for each failed check, and checks again. An agent can read checks[].user_action from iph doctor (JSON) and guide the user.
| Check | Required | What it is |
|---|---|---|
pairing | yes | The Mac holds a pairing record for the phone. If not: connect by USB and tap Trust |
connection | yes | The phone is visible over USB or the same Wi-Fi |
developer_mode | yes | Settings → Privacy & Security → Developer Mode. If it is off, iph doctor makes that switch appear |
developer_disk_image | yes | Source of the accessibility, display and input services. When missing, iph doctor fetches and installs it (see Install) |
screen_unlocked | yes | The phone is unlocked. Only lockdown's word decides a lock |
settings_in_front | yes | Settings comes to the front (fails when something covers it). When the screen cannot be read, accessibility_tree fails instead |
accessibility_tree | yes | Screen elements can really be read |
touch_input | yes | Scrolls the Settings list down one step and back to see that touch lands (--no-touch-test skips it) |
wifi | recommended | Wireless lockdown flags and the phone's usbmuxd Network entry (see below) |
auto_lock | recommended | Auto-Lock → Never for long sessions |
do_not_disturb | info | Shown only while Do Not Disturb from iph dnd on is still on |
Setup requirements and how to interpret the checks are in docs/onboarding.md (Korean).
Wi-Fi setup and troubleshooting
Pair by USB first, then keep the iPhone unlocked on the same LAN. The computer may use Ethernet. To enable wireless connections, run this while USB is attached:
iph doctor --fix-wifi
If the phone is still not discovered, register its IP below. Wireless setup details (Korean).
Notification banners take taps near the top of the screen. Banners cover the top of the screen and are not part of the accessibility tree. A tap near the top then lands on the banner and opens another app (this happened once during development). For long unattended work turn Do Not Disturb on with iph dnd on, and put it back with iph dnd off afterwards. Details: Do Not Disturb below.
Direct IP when automatic discovery fails
For a USB-trusted phone missing from discovery, use the IP shown in Settings → Wi-Fi → the network's info button:
iph devices # while USB is attached: note the UDID
iph --udid connect --ip # after unplugging USB iph --udid read
The Apple device service is still required. CLI, MCP and scripts share the saved address for the selected UDID; register it again if the IP changes. Connection details (Korean).
Commands
Every command prints JSON; add --human for people. The device is chosen by --udid, then IPH_UDID, then udid in ~/.config/iph/config.toml, then the only connected phone. With several phones and none chosen, you get an error with the list.
| Command | Does | ||
|---|---|---|---|
iph connect --ip | Verify and save the selected paired phone's IP | ||
iph devices | Connected phones, iOS version, connection, readiness | ||
iph setup / iph doctor | Preparation and checks | ||
iph read [--app] [--all] [--full] [--raw] [--max-age ms] | Elements on screen. --all includes off-screen ones, --full adds identifiers (about 0.5 s more), --raw attaches every numbered attribute | ||
iph find | Elements matching a selector | ||
iph tap [--long ms] [--double] | Tap the middle of an element, or a point | ||
iph swipe [--duration ms] [--drag] | Swipe. --drag slows to a stop before lifting, so nothing coasts | ||
| `iph pinch [in\ | out] [--scale F] [--rotate DEG] [--at selector \ | x,y] [--duration ms]` | Two fingers. out spreads them (zoom in, scale 2), in pinches them (zoom out, scale 0.5); --scale takes 0.25 to 4, --rotate degrees (clockwise is positive). They meet in the middle of the screen or at --at. screen_changed: false is a fair answer on a screen that does not zoom |
iph scroll [--until selector] [--max N] | One step, or until an element shows | ||
iph type [--clear] [--submit] | Paste text into the field that has the keyboard (any language, emoji). The clipboard is put back and the field's value checked | ||
iph key | return, esc, tab, cmd+a … | ||
iph button | Hardware buttons | ||
iph launch [--restart] [--env K=V]… [-- …] / iph apps | Launch an app, list apps. --env sets environment variables and what follows -- goes to the app as launch arguments (iph launch com.example.app --env TZ=UTC -- -AppleLanguages "(ko)"). Either one restarts a running app, since only a new process takes them; the result says restart_implied, with the arguments and the variable names (never their values) | ||
iph screenshot [-o file] | PNG capture | ||
iph batch | A JSON array of steps in one call | ||
iph script [--arg k=v] | Run JavaScript as given (- reads stdin) | ||
iph run [--arg k=v] / iph scripts | Run a saved script, list saved scripts | ||
iph mcp [--tools a,b] | MCP server on stdio | ||
iph dnd | Turn Do Not Disturb on, put the earlier Focus back, or show the current state | ||
iph syslog [--app app] [--process name] [--pid N] [--level L] [--after SEQ] [--grep RE] [--max N] [-o file] | Capture the phone's log in memory while other commands run; read returns what is new without stopping it, stop can return the latest matching entries. See Phone log | ||
iph stop | Stop the resident process for this phone |
Selectors
- A plain string is an exact label:
iph tap "General" label="exact",label~="contains",label/regex/role=button(application, button, switch, text_field, search_field, key, tab, header, text, image, link, adjustable, other)id=…matches the accessibi