Promptby Mr. Asad

set up Prompt

six steps, and the last one is optional. you'll need an iPhone on iOS 26 or later and a Mac with iTerm2 and Claude Code. Claude Code on your Mac does most of the work once you paste in the prompt below.

the setup prompt

it asks Claude Code on your Mac to follow our install steps one at a time and to explain each command before it runs it.

then paste it into Claude Code on your Mac. it takes you through the rest.

see the prompt
Help me set up Prompt by Mr. Asad on this Mac. It's an iPhone app that shows my Claude Code windows in iTerm2 and lets me reply from my phone.

Fetch https://prompt.asadshah.co.uk/install.md and follow it step by step, one step at a time. Tell me what each step does before you run anything, keep each message short, and wait for me to say done before the next one.

1. Check this Mac is ready: macOS, iTerm2 and Claude Code.
2. Install Prompt's Mac helper with the installer from the site, and tell me what it does before you run it.
3. Walk me through ticking iTerm2 > Settings > General > Magic > Enable Python API, and the one-time macOS prompt to allow it.
4. Show me the pairing code so I can scan it with the Prompt app on my iPhone.
5. Only if I want to use Prompt away from home, help me set up Tailscale on this Mac and my iPhone.

If anything goes wrong, the help page is https://prompt.asadshah.co.uk/support
  1. 1

    get the app on your iPhone

    on your iPhone, open the App Store page for Prompt by Mr. Asad and tap Get. it needs iOS 26 or later. you can try the demo and do the setup before you start a membership.

    the App Store page goes live as soon as Apple approves the app.

  2. 2

    paste the setup prompt into Claude Code on your Mac

    copy the setup prompt on this page. if you copied it on your iPhone, Universal Clipboard lets you paste it straight into Claude Code on your Mac, as long as both are signed in to the same Apple Account with Wi-Fi, Bluetooth and Handoff turned on. Claude Code then takes you through the rest one step at a time.

  3. 3

    let it install Prompt's Mac helper

    Claude Code installs a small helper on your Mac. it's the part that reads your Claude Code windows in iTerm2 and passes your replies in. it explains each command before it runs it.

  4. 4

    turn on iTerm2's Python API

    in iTerm2, open Settings, then General, then Magic, and tick Enable Python API. the first time the helper connects, macOS asks once if it can control iTerm2. click Allow.

  5. 5

    scan the code your Mac shows

    your Mac shows a pairing code. open Prompt on your iPhone and scan it with the camera. that pins the app to your Mac, so it only ever talks to that one Mac. keep both on the same Wi-Fi for this.

  6. 6

    use it away from home (optional)

    out of the box Prompt works when your iPhone and Mac are on the same Wi-Fi. to use it anywhere, install Tailscale on both and sign in to the same Tailscale account.

    get Tailscale

stuck on a step? the support page covers the usual ones, or email hello@asadshah.co.uk.