Pinky

Overview

Pinky is a cross-platform desktop app that lets MCP-capable AI agents operate a real iPhone or Android phone while the user watches and approves risky steps. Approvals are enforced by Pinky's gateway rather than by agent instructions, and each run can be reviewed through step records, screenshots, and screen recordings that stay on the computer.

Key Features

• Controls Android 10 to 17 phones and iPhones or iPads on iOS 17.4 or later from macOS, Windows, or Linux.
• Connects MCP-capable agents such as Claude Code, Claude Desktop, Codex, and Cursor, or scripts, over stdio or HTTP.
• Enforces approvals in the gateway for payments, trades, transfers, and other risky actions, with optional waiting for sends, orders, deletions, calls, installs, external links, and settings changes.
• Makes banking, wallet, and password-manager apps off-limits by default and prevents typing into password or one-time-code fields.
• On Android 13 and later, agents can work on a hidden second screen while the phone's own screen stays yours or stays off and locked.
• Lets the user take over at any time, pausing the agent, and records each step with screenshots and a screen recording exportable as an HTML report.

Use Cases

• Ask an agent to perform phone actions such as opening Messages and drafting or sending a reply while you approve sensitive steps.
• Review and approve payments, trades, or transfers that an agent attempts on a phone.
• Test agent workflows against iOS Simulators or Android emulators when a physical phone is not available.

Getting Started

• Download and install Pinky from the latest release for macOS, Windows, or Linux.
• Connect a phone by enabling the required debugging or developer mode, then follow Pinky's Add phone steps.
• Open Settings › Agents and connect an MCP-capable agent, or add Pinky's MCP server manually if the agent is not listed.
• Ask the agent to do something on the phone and watch it work in Pinky's window, approving any steps that wait.

Deployment & Requirements

• macOS 13 or later on Apple silicon or Intel, Windows 10 or 11 64-bit, or a 64-bit Linux system with Ubuntu 20.04, Debian 11, or newer and GTK 3.
• Android 10 to 17 phone and a USB cable; Wi-Fi pairing needs Android 11 or later, and Android 10 can move to Wi-Fi from USB.
• iPhone or iPad on iOS 17.4 or later and a USB cable for setup; iOS 17.4 to 26 also needs the WebDriverAgent helper installed once from Xcode.
• An MCP-capable agent such as Claude Code, Claude Desktop, Codex, or Cursor.
• For iPhone setup, Apple's developer disk image, which comes with Xcode and is not shipped by Pinky.

Before You Adopt

• License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
• Pinky is explicitly marked as pre-alpha, so users should treat it as immature and expect some functionality to still need real-world validation.
• The Windows installer is currently unsigned, so SmartScreen may warn users during installation.
• On iOS 17.4 to 26, the WebDriverAgent helper installed with a free Apple ID expires every 7 days and must be reinstalled.
• iPhone setup depends on Apple's developer disk image, which comes with Xcode and is not bundled by Pinky.
• Below iOS 27, the WebDriverAgent helper connection is not encrypted, so security depends on the Wi-Fi network.