ForkFree

Developer tools

terminal-phone

by govijr

terminal-phone shows an iOS simulator, or a paired real iPhone, inside your terminal window, where you can tap, type and swipe as on a real phone. It also lets AI coding agents drive the same phone through a command-line interface or an MCP server, so they can build, install and test iOS apps.

Proof level: ReadHidden gemNew and promisingMIT

Get it on GitHubCompare

No demo yet

Proof level: Read. We read its README and licence and ran our automatic checks. We have not run it yet. So this page is based on its README and our automatic checks.

The catch

Hidden gemIt puts a live, clickable iOS simulator or real iPhone inside your terminal, and gives AI agents an MCP server and JSON CLI to build, tap through and verify apps. It also covers flow tests with JUnit output, App Store screenshots and previews, and logs, which could save indie iOS developers real time. Best for indie iOS developers using AI coding agents on Apple silicon Macs.
New and promisingUnder two months old. Expect rough edges and fast changes.

Check this first: Only works on Apple silicon Macs with recent macOS and Xcode.

Things to check

  • Only works on Apple silicon Macs with recent macOS and Xcode
  • Release binaries are not Developer ID signed
  • Controlling a real iPhone acts on real accounts and data, and the WebDriverAgent helper has no password of its own
  • Real-device use needs an Apple Developer account

Can you use terminal-phone commercially?

Free to use, change and sell, including in paid products. Keep the copyright notice.

Not legal advice. Read the project's licence file before building a product on it.

What can you do with terminal-phone?

  • Build and launch an Xcode app in a simulator beside your shell, with automatic rebuilds on save
  • Let Claude Code, Cursor or Codex tap through your app and check the results via MCP
  • Record demo videos and make App Store-sized screenshots and app previews with device frames and captions

How do you get terminal-phone running?

Install with a curl script (or manual download or build from source) on an Apple silicon Mac with macOS 15+ and Xcode 26+; real iPhones also need an Apple Developer team to sign WebDriverAgent.

Follow the official instructions in the project README.

Make money with it

A freelance iOS developer could offer app store listing assets, such as framed screenshots and preview videos, as a paid service for other app makers.

An idea, not financial advice. Check the licence before charging for anything built on it.

Ways a business could use it

  • Automate iOS app testing in CI with YAML flow files and JUnit reports, reducing manual QA time
  • Produce App Store screenshots and preview videos in the correct sizes without separate design tools

Checked 10 Nov 2026. Summary drafted by AI from the project's README. Proof level 1 of 4, Read: we read its readme and licence and ran our automatic checks. we have not run it yet.

Similar tools in Developer tools

taste-skill Leonxlnx
Worth a look

Taste Skill is an add-on for AI coding agents such as Claude Code, Codex and Cursor. It guides the agent to design more distinctive websites and app screens by choosing an art direction, using credited real photographs and checking its own work in a real browser.

Proof level: Read 119.1k stars +646 a day MIT
gpu-unlock Zagitta
Check the licence

This tool unlocks the FP/BF16 instruction issue rate on Nvidia 3000-series cards, doubling the speed of certain operations.

Proof level: Read 20.5k stars +449 a day Unclear
ui vercel-labs
New and promising

UI SDK is a code library that handles the behaviour of interface parts such as keyboard navigation, focus, popups, drag and drop and accessibility markup. It works with React, Vue, Svelte, Solid and Web Components, and is designed so AI coding agents can build components with it.

Proof level: Read 6.2k stars +485 a day Apache-2.0