GStars
    ShawnPana

    ShawnPana/phone-harness

    #97 this week

    let your agent control your phone

    ai-agents
    ai
    automation
    developer-tools
    agent
    mobile-ai
    mobile-development
    Python
    MIT
    3.8K stars
    408 forks
    3.8K GitHub watchers
    Updated Oct 20, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    Ranks #97 of 2,531 repositories GStars tracks this week (top 4%).

    5 releases in the last 90 days, the latest 2 days ago, with 1 contributor on GitHub.

    Peaked at #97 in the weekly ranking the week of Oct 18, its best in the past year.

    Use Cases & Benefits

    • Enables AI agents to remotely control real iPhones and Android phones via mirroring or adb without jailbreaking or installing apps.
    • Provides a unified interface for phone control using OCR and accessibility trees, supporting multiple platforms and cloud-hosted devices seamlessly.
    • Use for automating mobile app testing and interaction on physical iPhones and Android devices from macOS, Linux, or Windows.
    • Use for integrating AI agents like Claude Code or Codex to perform complex tasks on phones, such as opening apps, typing, and tapping UI elements.
    • Use for renting cloud-based iPhones or Androids to develop, test, or demo mobile automation without owning physical devices.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present

    Watch-outs

    • Owned by an individual account with a single contributor on GitHub; plan for bus-factor risk.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    phone-harness · let your agent control your phone.

    Connect Claude Code, Codex, or any agent to your real phone. iPhone through the Mac's iPhone Mirroring window, Android over adb from macOS, Linux or Windows, or a Phone Harness Cloud phone — an Android over adb, or an iPhone over HTTPS. No jailbreak, no Xcode, nothing installed on the phone. The agent sees the screen, taps, types, and reads the result.

    Try Phone Harness Cloud → Hosted iPhones and Androids with stealth, real numbers, 2FA, and unlimited devices

    Get started by sending the setup prompt to your coding agent.

    Task: "Buy me a Waymo to Delah Coffee from my current location."

    The agent asks which phone is your default and walks you through the parts that need your hands: pairing iPhone Mirroring and granting Accessibility and Screen Recording, or turning on Android developer options and approving adb. It also offers a cloud Android — the same helpers with nothing to pair, and the first 100 minutes free — so an iPhone user can test on Android too. phone-harness --doctor checks the chain. Details in install.md.

    Hermes Agent: hermes plugins install ShawnPana/phone-harness/integrations/hermes adds a phone_exec tool and this skill. See integrations/hermes.

    Excerpt from the ShawnPana/phone-harness README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Oct 17: +62Oct 18: +36Oct 19: +29Oct 20: +33

    +160 stars over 4 days across 5 snapshot days; best day +62 on Oct 17.

    Forks

    408+37

    Open issues

    68+5

    Compared with peers in AI Agents

    Fastest-growing repositories GStars tracks in this cohort for the week of Oct 18, by 7-day star growth

    View category →
    ShawnPana/phone-harness compared with AI Agents repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    morluto/rea357.9K+129.4K603 days ago
    stablyai/orca101.3K+8.7K40today
    DietrichGebert/ponytail171.6K+8.1K755 days ago
    ruvnet/ruflo78.2K+3.6K40today
    vxcontrol/pentagi31.8K+2.7K7516 days ago
    ShawnPana/phone-harness3.8K+596312 days ago
    Category median101.3K+8.1K60—
    Compare phone-harness with rea, orca, ponytail →

    Discover Repositories

    Search across tracked repositories by name or description