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

  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.

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.

3,983 4,550 5,117 Nov 2, 2026 Nov 16, 2026
GitHub stars for Phone-use: 4,061 on Nov 2, 2026, 5,039 on Nov 16, 2026. Source: GitHub.

Ranking history

First ranked in week 45, 2026.

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.

Also compared with Phone-use on these pages:

Last updated Nov 16, 2026. Tracked since Nov 2, 2026. Parts of this summary required judgment because the source material was brief. Spotted an error? Tell us.