Give your agent
an iPhone.

An open-source macOS CLI that lets AI agents control a real iPhone.

Get started Watch the demo

iPhone-use in action

From request to result.

Agent integrations

Keep your favorite agent.

Codex
Claude Code
DeepSeek Harness
Cursor
OpenCode
Amp
Kiro
Qwen Code
Kimi Code

Antigravity
TRAE
Gemini CLI
GitHub Copilot
Cline
Augment Code
goose
Zed
Junie

Beyond the chat window

Real apps.
Real actions.

Your agent does the thinking. iPhone-use gives it a way to see and operate your iPhone, one step at a time.

See.: 01

Read screen; Read the screen. Understand what comes next.
Act.: 02

Tap General; Tap, swipe and type. Move the task forward.
Verify.: 03

Page confirmed; Look again. Check that the result matches the goal.

Runs locally on your Mac with a connected iPhone. Your chosen agent provides the model and planning.

Make the connection

Your next task starts here.

Install iPhone-use, connect your iPhone, and give your agent something to do.

Before you begin: Mac, iPhone & Xcode

Standard mode requires Apple Silicon, macOS 27 / iOS 27 and full Xcode, plus a trusted USB-connected iPhone with Developer Mode enabled. Development signing and setup are only required for Runner mode.

Release 0.5.0 was verified on iPhone 12 Pro / iOS 27.0.1 with the published CLI and matching Runner. Fresh-Mac and free Personal Team setup remain unverified. Check prerequisites. Compare standard and runner.

1. Install the CLI.

In Terminal on your Mac:

brew install hughlee824/tap/iphone-use
iphone-use --version

2. Connect your agent.
Codex

Run in Terminal, then start a new Codex task:
```
codex plugin marketplace add hughlee824/iphone-use
codex plugin add iphone-use@iphone-use
```
Requires a Codex release with codex plugin support. Command names checked on CLI 0.146.0. Invoke $iphone-use:iphone-use in the new task.
Claude Code

Run in Terminal, then start a new Claude Code session:
```
claude plugin marketplace add hughlee824/iphone-use
claude plugin install iphone-use@iphone-use
```
Invoke /iphone-use:iphone-use in the new session. The plugin adds device instructions; install the CLI and Xcode separately.
DeepSeek Harness

Run with the CLI bundled with DeepSeek Harness, then restart the app:
```
dsh plugin --profile desktop add dsh-iphone-use
```
Start a new session and ask it to use the iphone-use skill. Its shell and image tools must run on the Mac connected to your iPhone.

Prefer the app? In Add plugin, choose Official npm registry and enter dsh-iphone-use. DeepSeek Harness setup guide.
Others

For Cursor or OpenCode, run the matching commands in your project directory with Node.js 20 or later:
Cursor
```
npx iphone-use-skill install --agent cursor
npx iphone-use-skill check --agent cursor
```
OpenCode
```
npx iphone-use-skill install --agent opencode
npx iphone-use-skill check --agent opencode
```
Start a new agent session in that project and ask it to use the iphone-use skill. Your agent needs local command execution and image-reading tools.

For another client, follow the portable skill guide.
3. Prepare your iPhone.

Plug it in, trust the Mac, enable Developer Mode, and keep it unlocked. Copy the device ID returned by devices:
```
iphone-use devices
export IOS_UDID='YOUR_DEVICE_ID'
iphone-use config set mode standard
```
setup is optional and only prepares Runner mode with your development signing. Standard mode uses Apple PNG and native HID without starting Runner. Mode and signing guide.
4. Give your agent its first task.

Invoke the skill in a new client session, then send:

Open Settings on my iPhone, navigate to General, read the screenshot to verify the page, then disconnect. Do not change any settings.

You’re done when the agent reads the General screenshot, confirms the page, and reports clean disconnection. A successful tap alone isn’t task completion.
Read the first-task guide