Phone-use
Phone-use is a command-line tool that lets AI agents like Claude Code or Codex tap, scroll, type, and read a real phone for developers and power users.
What it is good for
- Automating repetitive tasks in phone apps
- Letting an AI agent use my real iPhone
- Controlling an Android phone from an AI coding agent
- Testing mobile app flows without installing anything on the phone
At a glance
- Who it is for
- Setup difficulty
- Technical ยท Guided command-line setup
Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.
- Cost
- Free tier plus paid plans
- Type
- Agent app
- Tasks
- Works with
- Claude Code, Codex, Hermes Agent, OpenClaw, iPhone Mirroring, adb
How to get started with Phone-use
- Send the setup prompt from the README to your coding agent, such as Claude Code or Codex.
- Let the agent install the CLI and ask which phone you want to use.
- Follow the agent's steps that need your hands, such as pairing the phone or enabling USB debugging.
- Run
phone-harness doctorto check the setup.
From the project's own documentation. If a step does not match what you see, the official pages have the latest instructions.
Before you try it
- iPhone use needs macOS 15+, iPhone Mirroring paired to an iOS 18+ iPhone, and Accessibility and Screen Recording permission.
- Android needs adb and USB debugging, on macOS, Linux or Windows.
- Cloud phones need a Phone use Cloud account; cloud Android also needs adb.
- Text is read by OCR, so unlabeled icons need a screenshot and a vision-capable model.
Momentum
- Rank this week
- Not ranked (last #96, week 45, 2026)
- Best rank
- #96 week 45, 2026
- GitHub stars
- 5,039
GitHub numbers as of Nov 16, 2026. Updated weekly.
Ranking history
Official links
Questions
- Is Phone-use free?
- It has a free plan and paid plans, according to its own description.
- Do I need to know how to code to use Phone-use?
- You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
- What does Phone-use work with?
- According to its own documentation, it works with Claude Code, Codex, Hermes Agent, OpenClaw, iPhone Mirroring, and adb.
- How do I get started with Phone-use?
- 1. Send the setup prompt from the README to your coding agent, such as Claude Code or Codex. 2. Let the agent install the CLI and ask which phone you want to use. 3. Follow the agent's steps that need your hands, such as pairing the phone or enabling USB debugging. 4. Run phone-harness doctor to check the setup.
- What should I know before trying Phone-use?
- iPhone use needs macOS 15+, iPhone Mirroring paired to an iOS 18+ iPhone, and Accessibility and Screen Recording permission. Android needs adb and USB debugging, on macOS, Linux or Windows. Cloud phones need a Phone use Cloud account; cloud Android also needs adb. Text is read by OCR, so unlabeled icons need a screenshot and a vision-capable model.
- What is Phone-use good for?
- Automating repetitive tasks in phone apps, letting an AI agent use my real iPhone, controlling an Android phone from an AI coding agent, and testing mobile app flows without installing anything on the phone.
Similar agents to Phone-use
- iphone-use
Focuses only on iPhone, while this one also covers Android and hosted cloud phones.
- mobile-mcp
Works as an MCP server aimed at testing on simulators, emulators, and real devices.
- AutoCua
A Python agent that controls computers, browsers, or phones itself rather than being driven by your coding agent.
- Peekaboo
Controls the Mac screen and apps rather than a phone.
- cua
Gives agents full desktops to operate instead of a phone.
- ESP32 iPhone Agent
ESP32 iPhone Agent is an agent app that lets an AI model see and operate a real iPhone through a $7 ESP32 board for tinkerers.