All pages
Lesson 7.3 · Beyond the Mac · 10 min
The iPhone remote
Pair your phone, approve from the lock screen, drive your Mac.
After this lesson, your iPhone is paired to your TRMNLY account and can drive your Mac. You can read and type into its panes, answer the agent's approval requests from the lock screen, and get told when a long job finishes.
Time: 10 minutes · Works on: iPhone, macOS app
What the app is
The iPhone app is a remote control, not a terminal of its own. It reaches your Mac through trmnly.dev, so the Mac has to be running TRMNLY, paired and online. It can also drive your cloud workspace, which needs no Mac at all.
The app is in beta on TestFlight. Join from the Join on TestFlight link on trmnly.dev. TestFlight installs it like any other app.
Pair your Mac
The Mac side comes first, because the phone needs something to drive.
- On the Mac, press
⌘,and open the AI Agent tab. - Scroll to Remote Control (trmnly.dev) and turn on Enabled.
- Under Pair this Mac, press Start pairing. A browser window opens on trmnly.dev. Sign in and confirm the code it shows. Settings then reads Paired with a device id.
TRMNLY now runs a tunnel so paired devices can reach this Mac. If you don't have cloudflared installed, TRMNLY downloads a pinned, checked copy for the tunnel.
Sign in on the phone
- Open TRMNLY on the iPhone.
- Choose how to sign in:
- Sign in with GitHub if you signed up with GitHub. The app copies a short code and opens GitHub's device page. Paste the code and approve.
- Use a pairing code if you sign in to trmnly.dev with a password. The phone shows a code to confirm on a trmnly.dev page you're signed in to.
- If you used a pairing code, tick This is my iPhone running TRMNLY when you confirm. That makes it your trusted phone, which can type into the Mac without an extra prompt on the Mac.
A phone signed in through GitHub starts unconfirmed. The app shows Confirm this iPhone with a link. Confirm it on your trmnly.dev dashboard, then retry.
Find your way around
The tab bar has Now, Terminal, Prompts, Chat and Browse. Account is in the title bar.
- Now shows what needs you: waiting approvals from every Mac, the panes, and which ones look like they're waiting or working. The tab's badge is the number of approvals.
- Terminal reads a pane and types into it. Tap the title to pick a project, then a tab, then a split. By default it follows whatever the Mac has focused.
- Prompts sends your saved prompts to a pane.
- Chat is the project's message room.
- Browse covers files, tasks and git for the chosen project.
The switcher in the title bar picks your Mac or the Cloud workspace. With several Macs, Choose a Mac… lists them all.
Approve from your phone
When the agent or an MCP client on your Mac reaches a tool that needs your OK, the phone gets the request. It appears on Now if the app is open, and as a notification if it isn't.
- On the Mac, ask the sidebar agent to do something that needs approval, such as writing a file.
- On the phone, read the card. It shows a safety badge (Read-only, Writes or Dangerous), who asked, and the arguments. A file edit shows the diff.
- Choose Approve or Deny. The Mac waits two minutes, then denies.
- Allow for 15 min approves this call and similar ones from this phone in this project for 15 minutes. It asks for Face ID first, and it's never offered for a dangerous tool.
From a notification, Approve and Allow for 15 min ask you to unlock the phone. Deny doesn't.
Tip: Under Account → Security, Ask before approving dangerous tools is on by default. Leave it on.
Get told when a job finishes
- In Terminal, point the phone at a pane running something long, such as a test suite.
- Tap the 🔔 in the toolbar.
- Lock the phone. When the pane goes quiet or its command finishes, you get a notification. Tap it to open the pane.
A watch fires once and lapses after 24 hours. Now also has Keep awake, which holds the Mac awake for 1 hour or 4 hours while you're away.
If something goes wrong
- The pairing code never claims. Make sure you're signed in to trmnly.dev in the browser. Codes expire after 10 minutes, so start pairing again.
- The phone says the Mac is offline. Check the Mac is awake, TRMNLY is running, and Enabled is on under Remote Control (trmnly.dev).
- You lose the phone. Revoke it from the devices list on your trmnly.dev dashboard. It stops working at the next heartbeat.
Check yourself
- The Mac's Remote Control (trmnly.dev) section reads Paired.
- Terminal on the phone shows the same text as a pane on the Mac, and text you send appears there.
- You approved one agent request from the phone.
Go further
- Remote control: tunnels, scopes, the trusted phone, widgets, Shortcuts and the Apple Watch.
- Safety and approvals: what decides which calls need approval in the first place.
- The cloud workspace: driving the cloud box from the same app.