ShawnPana / phone-harness

项目摘要

phone-harness is a Python tool that lets AI agents (Claude Code, Codex, or any agent) control real mobile devices—iPhone via Mac Mirroring, Android via ADB, or cloud-hosted phones—through a unified Python API for screen reading, tapping, typing, and app navigation.

为什么值得关注

It bridges the gap between coding agents and real mobile devices without requiring jailbreaks, Xcode, or anything installed on the phone, enabling AI agents to perform end-to-end mobile tasks like booking rides or testing apps through natural language.

优势

• Unified Python API across iPhone (Mirroring), Android (ADB), and cloud-hosted phones
• Zero phone modification required — no jailbreak, no Xcode, nothing installed on device
• Agent-native design with intuitive helpers like tap_text(), type_text(), screen(), open_app()
• Cloud phone offering with real numbers, 2FA support, and unlimited devices for testing without hardware
• Very active development with 8 releases in 6 months and strong community adoption (3.6k stars)

局限性

• Small team of only 3 contributors raises long-term sustainability concerns
• iPhone support limited to macOS via iPhone Mirroring, not cross-platform
• Complex setup chain requiring Accessibility and Screen Recording permissions on Mac, or Android developer options
• No Docker support for containerized deployments
• Documentation appears truncated in README with incomplete usage reference

使用场景

• AI-driven end-to-end mobile app testing and QA automation
• Automating mobile workflows (ride booking, messaging, form filling) through natural language agent commands
• Cross-platform mobile development testing using cloud phones without physical devices
• Mobile app prototyping and demo creation via coding agents