Introducing terminal-phone. Your real iPhone or iOS simulator, inside your existing terminal. - Let your agents use your phone - Test your apps with scripts - Create beautiful App Store videos/screenshots - 12 device frame colors - Free & open source

you can easily capture beautiful app store screenshots in different dimensions and device frames right from your terminal.

you can easily create beautiful videos with different backgrounds, captions, device frames and zoom levels right from your terminal.

Repo:

what terminal is this govi?

its my govi terminal :)

Can’t you just use Expo?

Expo is great for building React Native apps, but it doesn't solve the same problem. terminal-phone is for viewing and controlling an iOS simulator or real iPhone from the terminal and letting an AI agent inspect and interact with it, regardless of whether the app was built with Expo, Swift, or anything else.

Wow, amazing project! iPhone Duo is a beast when it comes to simulator and what Apple lets you do. That would be the ultimate test - folding it, unfolding it, landscape and portrait.

duo in your terminal would be insanely cool!!

a phone running right inside your terminal is soo coool, agents tapping through the real app instead of guessing is the part i would use

looks cool

Can this be used for Qa?

Yes!! it can be used for qa: run an app on a simulator or paired iPhone, interact with it from the terminal, inspect accessibility elements, capture screenshots or recordings, and let an agent verify expected outcomes.

that's dope

Incredible work - will use this

App Store screenshots and videos straight from the terminal is a sick idea lol. That step always takes way longer than it should

This is so sick

Works on Windows?

no only on mac for now

You’re cooking 🔥

does it overrides default Xcode view?

no it doesnt

terminal-mac, terminal-phone. you're rebuilding a datacenter one terminal at a time

wow looks great. would love to contribute

controlling an iphone straight from terminal is crazy cool

Testing apps with scripts inside the terminal, the iOS simulator running there is the part I would reach for first.

Love your take on this functionality!

u are cooking 🔥

Cool stuff

my agents are about to start leaving me voicemails

insane this is awesome

the app store screenshots part is lowkey the best feature

terminal?

LFG🔥

手机也能接进这套流程，测试和录演示都省事不少，做应用的门槛又低一点了。

My goodness the pace at which you move! 🔥 solid work!

Damn this is good one

Why do you need to use this via terminal. ? Also there is Xcode plugin available in Claude.

Does the same script work on both a real iPhone and the simulator, or do you need separate handling for things like keyboard input and system dialogs?

Amazing work 👍🏻

every action returns the screen it produced, so the agent can tell when a tap didn't do anything instead of continuing as if it worked.

The 'let your agents use your phone' bullet is the whole point of this. A simulator covers the happy path, but the real phone is where the flaky stuff lives — permissions, background kills, the things you only find when a real device says no.

Agents using a real iPhone is the missing piece for testing iOS apps end to end. The App Store screenshots part alone saves a whole afternoon per release.