support
pairing your iPhone with your Mac
- on your Mac, run
promptctl pairin Terminal or iTerm2, or ask Claude Code to do it. a code appears. - open Prompt on your iPhone and scan the code with the camera.
- keep your iPhone and Mac on the same Wi-Fi while you pair.
pairing pins the app to that one Mac. if you change Mac or reinstall the helper, run promptctl pair again and scan the new code.
Prompt can't find the Mac helper
your Mac needs to be awake and on the same Wi-Fi as your iPhone, or on Tailscale. a Mac with its lid closed on battery is asleep, and Prompt can't reach it until it wakes. on the Mac, run promptctl doctor. it checks the helper is running and tells you what to fix. if it says the helper isn't installed, paste the setup prompt from the setup page into Claude Code again.
Local Network permission
Prompt asks for Local Network access so it can reach your Mac over your Wi-Fi. if you tapped Don't Allow, go to Settings on your iPhone, then Privacy and Security, then Local Network, and turn Prompt on.
"Enable Python API" in iTerm2
the helper uses iTerm2's Python API to read your windows and type your replies into them. in iTerm2, open Settings, then General, then Magic, and tick Enable Python API. the first time the helper connects, macOS asks if it can control iTerm2. click Allow. if you clicked Don't Allow, open System Settings on your Mac, then Privacy and Security, then Automation, and turn on iTerm2 for Prompt's helper. then run promptctl doctor.
notifications aren't arriving
- on your iPhone, check Settings, then Notifications, then Prompt, and make sure notifications are allowed.
- check the notification setting inside Prompt's own Settings screen.
- your Mac sends the notifications, so it needs to be awake and online.
- run
promptctl doctoron your Mac. it checks the helper can reach the notification relay. - Focus modes on your iPhone can hold notifications back.
using it away from home
out of the box Prompt reaches your Mac when both are on the same Wi-Fi. to use it anywhere, install Tailscale on your Mac and your iPhone and sign in to the same Tailscale account on both. your Mac still needs to be awake and online.
photos aren't sending
check Prompt is connected to your Mac (the window list updates when it is). large photos are made smaller before they go, so give a slow connection a moment. if a photo still won't send, pick it again from the photo picker and check the window you're sending to is still open on your Mac.
cancel, restore and refunds
to cancel, go to Settings on your iPhone, tap your name, then Subscriptions, pick Prompt and tap Cancel Subscription. your membership runs to the end of the month you've paid for. changed phone or reinstalled? tap Restore in the app. got a code? tap Redeem a code. Apple handles all payments, so refunds go through Apple at reportaproblem.apple.com.
uninstall the Mac helper
on your Mac, run curl -fsSL https://prompt.asadshah.co.uk/mac/uninstall_public.sh | bash. it stops the helper and removes it from your Mac. then delete the Prompt app from your iPhone if you no longer want it. Claude Code and iTerm2 aren't touched.
what you'll need
an iPhone on iOS 26 or later, and a Mac with iTerm2 and Claude Code. Prompt shows Claude Code windows running in iTerm2.