phone-harness
ShawnPana
Lässt einen Coding-Agenten dein echtes iPhone oder Android-Telefon steuern, über Bildschirm-Lesen und Taps, ohne Jailbreak oder SDK.
Was ist phone-harness?
Verbindet Claude Code, Codex oder jeden anderen Agenten mit einem echten Telefon: iPhone über das iPhone-Übertragung-Fenster des Mac, Android über adb von macOS, Linux oder Windows aus. Der Agent liest den Bildschirm (Screenshots, OCR), tippt, schreibt und scrollt über dieselben Helper-Funktionen, unabhängig von der Plattform, ohne Jailbreak, ohne Xcode und ohne irgendetwas auf dem Telefon selbst zu installieren. Ein kostenpflichtiges Zusatzangebot namens Phone Harness Cloud vermietet Android-Telefone minutenweise für alle ohne Ersatzgerät.
| Merkmal | Wert |
|---|---|
| Maintainer | ShawnPana |
| GitHub-Stars | 2.983 (Stand 2026-09-23) |
| Forks | 306 |
| Lizenz | MIT |
| Lizenztyp | OSI-open |
| Kategorie | Computer-Use und autonome Agents |
| Status | Aufsteigend |
| Edition | 2026-09 |
| Zuletzt geprüft | 2026-09-23 |
phone-harness im Detail
Mobile App-Automation bedeutete bisher meist, ein Telefon zu jailbreaken, Appium oder XCUITest aufzusetzen oder ein SDK auf dem Gerät zu installieren, nur damit ein Skript irgendwo hintippen kann. phone-harness will genau diese drei Voraussetzungen loswerden. Es verbindet einen bestehenden Coding-Agenten wie Claude Code oder Codex mit einem echten Telefon, so wie ein Mensch es benutzen würde: Es schaut auf den Bildschirm, tippt, schreibt Text und scrollt. Die iPhone-Steuerung läuft über macOS' eingebaute Funktion iPhone-Übertragung, das Telefon wird also als Fenster gespiegelt und Eingaben werden als Touches weitergegeben. Android-Steuerung läuft über adb, von macOS, Linux oder Windows aus. Auf dem Telefon selbst wird nichts installiert, und es braucht weder Jailbreak noch Xcode-Toolchain.
Jede Plattform wird über dieselbe Reihe von Python-Helpern gesteuert (open_app, tap_text, type_text, ocr, scroll und ähnliche), sodass dasselbe Automatisierungsskript funktioniert, egal ob das verbundene Gerät ein iPhone oder ein Android-Telefon ist. Hinter dieser Schnittstelle kümmert sich das Projekt laut Commit-Historie um eine lange Liste echter Praxisfälle: das Telefon im Hintergrund steuern, ohne dem Fenster den Fokus zu stehlen, Scroll-Gesten je App unterscheiden, eine tote Spiegelungs-Sitzung strukturell statt über UI-Text-Abgleich erkennen, und den Fokus live auslesen, um zu bestätigen, dass eine App-Aktivierung wirklich geklappt hat. Wer kein Ersatzgerät hat, kann über das kostenpflichtige Zusatzangebot Phone Harness Cloud ein Android-Telefon minutenweise über dieselbe adb-Schnittstelle mieten, sodass jeder vorhandene Helper unverändert weiterfunktioniert.
Die naheliegende Zielgruppe sind Entwickler, die einen Agenten eine echte mobile App bedienen lassen wollen: einen Checkout-Flow testen, ein Support-Ticket mit 2FA einreichen, oder eine Aufgabe automatisieren, die keine offizielle API bereitstellt. Weil die Einrichtung aus einem einzigen Prompt besteht, den ein Coding-Agent selbst ausführt (Repo klonen, CLI installieren, als Agent-Skill registrieren und durch das Pairing führen), richtet sich das Tool an Leute, die Agenten bereits Shell-Zugriff geben, statt eine Geräte-Farm von Hand zu konfigurieren. Die Cloud-Mietoption erweitert das auf alle, die kein Ersatz-iPhone oder Android-Gerät für Automation übrig haben.
Die Entwicklung ist faktisch eine Ein-Personen-Leistung: Von rund 98 Commits stammen 97 von einer einzigen Autorin, nur ein externer Beitrag behebt einen Scroll-Erkennungsfehler. Telemetrie über PostHog ist standardmäßig an, opt-out statt opt-in, und sendet ein Event pro CLI-Lauf. Das README ist stark darauf ausgelegt, Nutzung zum kostenpflichtigen Dienst Phone Harness Cloud zu lenken, mit UTM-markierten Links in fast jedem Abschnitt, ein legitimer, aber erwähnenswerter kommerzieller Winkel für ein sonst MIT-lizenziertes Open-Source-Tool. Volle iPhone-Automation ist zudem an macOS gebunden, da iPhone-Übertragung eine reine Mac-Funktion ist. Einen Weg, ein iPhone von Linux oder Windows aus zu steuern, gibt es nicht.
phone-harness löst ein echtes, bisher umständliches Problem, indem es einem Agenten erlaubt, ein echtes Telefon zu bedienen, ohne es zu jailbreaken oder eine Begleit-App auszuliefern, und die 40 offenen Issues sowie drei ausgelieferte Releases in sechs Wochen deuten darauf hin, dass Leute es tatsächlich nutzen und nicht nur mit einem Stern versehen. Einen Blick wert ist es, wenn du heute agentengesteuerte Telefon-Automation willst und mit einem einzelnen Maintainer, standardmäßig aktiver Telemetrie und einem in die Doku eingewobenen Cloud-Upsell leben kannst. Zu früh ist es, wenn du ein Projekt mit verteilter Maintainer-Struktur brauchst, Telemetrie lieber explizit aktivierst statt abschaltest, oder iPhone-Automation von etwas anderem als einem Mac aus brauchst.
Vor- & Nachteile
Pros
- Echte, funktionierende Automation sowohl für iPhone (über iPhone-Übertragung) als auch Android (über adb), mit detaillierter Behandlung von Randfällen wie Hintergrund-Scrolling und Fokus-Diebstahl
- MIT-lizenzierter Kern ohne Jailbreak, SDK oder Geräte-Installation
- Aktive Entwicklung mit drei ausgelieferten Releases (0.1.0 bis 0.3.0) über rund sechs Wochen und 40 offenen Issues als Zeichen echter Nutzung
Cons
- Faktisch ein Ein-Personen-Projekt (97 von rund 98 Commits von einer Autorin)
- Telemetrie (PostHog) ist standardmäßig an, nur per Opt-out abschaltbar, und das README lenkt mit UTM-markierten Links durchgängig zum kostenpflichtigen Phone Harness Cloud
- Volle iPhone-Steuerung hängt an macOS' iPhone-Übertragung und funktioniert daher nur von einem Mac aus; Android-Steuerung funktioniert von macOS, Linux oder Windows
Lizenz
MIT (OSI-open)
Wann interessant
Du willst einen Agenten ein echtes Telefon bedienen lassen (App-Tests, Käufe, Formulare ausfüllen), ohne es zu jailbreaken oder etwas darauf zu installieren.
Wann zu früh
Du brauchst eine Governance mit mehreren Maintainern, oder willst Telemetrie standardmäßig aus statt per Opt-out.
Dieses Repo war in der Ausgabe 2026-09 des Open-Source-KI-Radars.
UI-TARS-desktop
bytedance
Native Desktop-App für einen GUI-/Computer-Use-Agent, angetrieben vom open-weight-Modell UI-TARS.
strix
usestrix
Framework autonomer 'KI-Hacker'-Agents für dynamische Anwendungssicherheitstests.
Page Agent
alibaba
In-Page-JavaScript-GUI-Agent - jede Webseite mit natürlicher Sprache steuern, kein headless-Browser oder Extension.