The lpm companion for iPhone
Your Mac terminals and AI agents, live in your pocket.
The lpm iOS app pairs with lpm on your Mac and mirrors your terminals in real time — type into a running agent, start and stop projects, and get a nudge the moment Claude Code or Codex is waiting on you. The work still runs on your Mac; your phone is a live window into it.
Install lpm on your Mac, then scan one QR code to pair your iPhone.
Your agents keep working — but only while you're sitting in front of them
AI coding agents run for minutes at a time, then wait for you. If you're not at your Mac, that wait is dead time you never even see.
Agents stall the second you step away from your desk
You kick off a long refactor with Claude Code and go make coffee. Two minutes in, the agent hits a question and waits. It sits idle until you're back at the keyboard — and you have no idea it stopped.
You can't tell if a build is done from across the house
Tests are running, a deploy is churning, an agent is thinking. To know whether any of it finished, you have to walk back to your Mac, wake it, and read the terminal. There's no way to glance and know.
A one-line answer means a full trip back to your desk
The agent just needs a yes, a file name, or a quick correction. But typing that one line means being physically in front of your Mac. The smallest input becomes the biggest interruption.
The detached-window experience, in your pocket
Six things the lpm iOS app lets you do without walking back to your Mac.
A live mirror, not a screenshot
Every terminal on your Mac streams to your phone character by character, with full scrollback. It's the same session — what you see on the phone is exactly what's on the Mac, updating as it happens.
Type straight into a running agent
Tap into any terminal and start typing. Your keystrokes go to the real session on your Mac, so you can answer a prompt, correct an agent, or run git status — all from the couch.
Know the moment an agent needs you
When Claude Code or Codex finishes or stops to ask a question, the project's status flips to Waiting on your phone. The idle time between a stall and your reply disappears.
Start, stop, and switch projects
Browse every project from your phone, start or stop the whole stack, and toggle individual services on and off. Spin up the API before you're back at your desk so it's ready when you sit down.
Run actions and open terminals remotely
Trigger a saved action — a test run, a linter, a deploy script — or open a fresh terminal in any project. It runs on your Mac in the normal flow and shows up the next time you look.
Send a screenshot to your agent
Snap or pick an image on your phone and drop it into the composer. lpm moves it onto your Mac and pastes the path so the agent can read it — handy for a bug screenshot or a design reference on the go.
From download to controlling your Mac from your phone
- 1
Install lpm on your Mac
Download the native macOS app and open your projects as usual. The companion talks to this app — it’s where every terminal and agent actually runs.
- 2
Add a device and scan the QR code
In Settings → Mobile devices on your Mac, add a device to reveal a one-time QR code. Open the lpm app on your iPhone and scan it. Pairing is one tap — no account, no sign-in.
- 3
Your projects appear on your phone
The phone lists every project and terminal, live. Tap a terminal to watch it stream, tap into it to type, or start and stop projects right from the list.
- 4
Stay in the loop anywhere
On the same Wi-Fi it just works. Away from home, put both devices on a Tailscale tailnet and connect to your Mac from anywhere — your terminals follow you.
Remote access to your dev machine, on your terms
The phone controls a real terminal on your Mac — so the connection is built to be private, direct, and revocable.
Per-device tokens, stored on the phone
Pairing issues a unique token that lives in your iPhone's Keychain. Your Mac only ever stores its hash — the raw token never leaves the device. Revoke a phone in Settings and its access is gone instantly, live connection dropped.
Nothing runs in the cloud
There's no lpm server in the middle. Your phone connects directly to your Mac on your own network. No project data, no terminal output, and no keystrokes ever pass through a third party.
You choose the reach
By default the server only listens on your Mac. Opt in to your local network when you want the phone on the same Wi-Fi, or use a Tailscale tailnet for encrypted access from anywhere. You decide how far it goes.
Questions about the lpm iOS companion
Do I need lpm on my Mac to use the iOS app?
Yes. The iOS app is a companion, not a standalone terminal. Every project, service, and AI agent runs on your Mac inside lpm — the phone is a live display and input client that pairs with it. Install lpm on your Mac first, then pair your iPhone.Does my code or terminal output go through the cloud?
No. The phone connects directly to lpm running on your Mac over your own network. There is no lpm server in the middle. Terminal output, keystrokes, and project data never pass through a third-party service.Can I use it when I'm away from home?
Yes. On the same Wi-Fi it works out of the box. Away from your network, put both your Mac and iPhone on a Tailscale tailnet and connect to your Mac's tailnet address — that gives you an encrypted link from anywhere. Native TLS is a planned follow-up.Is it safe to control my dev machine from my phone?
Pairing issues a per-device token that lives only in your iPhone's Keychain; your Mac stores just its hash. By default the server listens only on your Mac, and you explicitly opt in to reach it over your local network or a tailnet. You can revoke any device from lpm Settings at any time, which immediately drops its connection.What can I actually do from the phone?
Watch any terminal stream live with full scrollback, type into a running session, answer or correct an AI agent, start and stop projects, toggle individual services, run saved actions, open new terminals, and send an image from your phone into a terminal's composer. You also see when an agent flips to Waiting so you know the moment it needs you.Does the agent keep running if my phone locks or disconnects?
Yes. All the work runs on your Mac. The phone is just a window into it — if it locks, sleeps, or loses the connection, your terminals and agents keep going. Reconnect and you pick up the live stream where it is.
Keep reading
Put your terminals in your pocket.
Install lpm, scan one code, and never miss a waiting agent again.
Download the native macOS app, open a project, and pair your iPhone in Settings → Mobile devices. Free, native, and yours — the work stays on your Mac, the control comes with you.