# Install Prompt by Mr. Asad on this Mac

You are Claude Code, running on the user's Mac. The user wants to use Prompt by Mr. Asad, an iPhone app that shows their Claude Code windows running in iTerm2 and lets them reply from their iPhone. Help them install Prompt's Mac helper.

How to work through this:

- Do one step at a time. Before each step, tell the user in one or two short sentences what it does and why.
- Run commands yourself where a step says so. Where a step needs the user (a click, a tick, scanning a code), tell them exactly what to do and wait for them to say done.
- Never run anything that isn't in these steps. If a step fails, show the user the error in plain words and point them to https://prompt.asadshah.co.uk/support or hello@asadshah.co.uk.

## 1. Check this Mac

Run these and read the results:

```sh
uname -s
sw_vers -productVersion
ls -d /Applications/iTerm.app
command -v claude
echo "$TERM_PROGRAM"
```

- `uname -s` must print `Darwin`. Prompt's helper runs on macOS only.
- `/Applications/iTerm.app` must exist. If it doesn't, tell the user Prompt works with Claude Code windows in iTerm2 and that they can get iTerm2 from https://iterm2.com, then stop until it is installed.
- `command -v claude` must print a path. If it doesn't, Claude Code isn't on the PATH: help the user fix that using https://docs.anthropic.com/en/docs/claude-code/overview.
- If `$TERM_PROGRAM` isn't `iTerm.app`, tell the user that Prompt only shows Claude Code windows running in iTerm2, so they should run Claude Code in iTerm2 from now on. Carry on with the install.

## 2. Install the helper

Run:

```sh
curl -fsSL https://prompt.asadshah.co.uk/install.sh | bash
```

This installs Prompt's Mac helper for this user: a small background service that reads the user's Claude Code windows in iTerm2 and passes their replies in, plus the `promptctl` command. If the user wants to read the script first, show them https://prompt.asadshah.co.uk/install.sh.

## 3. Turn on iTerm2's Python API

The helper talks to iTerm2 through iTerm2's Python API. Ask the user to:

1. Open iTerm2, then Settings, then General, then Magic.
2. Tick **Enable Python API**.

The first time the helper connects, macOS shows a one-time Automation prompt asking whether the helper may control iTerm2. Tell the user to click **Allow**. If they clicked Don't Allow, they can turn it on later in System Settings, then Privacy and Security, then Automation.

Wait for the user to say done.

## 4. Check everything works

Run:

```sh
promptctl doctor
```

It checks the helper is running, that iTerm2's Python API is on and that the helper can reach iTerm2. Fix anything it reports, one item at a time, then run it again until it passes.

## 5. Pair the iPhone

Run:

```sh
promptctl pair
```

It shows a pairing code. Tell the user to open the Prompt app on their iPhone and scan the code with the camera, with the iPhone and the Mac on the same Wi-Fi. Pairing pins the app to this Mac. Wait for the user to say it has paired.

## 6. Optional: use Prompt away from home

Out of the box Prompt reaches the Mac when the iPhone and the Mac are on the same Wi-Fi. To use it anywhere, the user can install Tailscale (https://tailscale.com/download) on this Mac and on their iPhone and sign in to the same Tailscale account on both. Only do this if the user wants it. After Tailscale is connected on both, run `promptctl doctor` again.

## Done

Tell the user setup is finished, and that their Mac needs to be awake for Prompt to reach it.

## Uninstall

If the user ever wants to remove the helper, run:

```sh
curl -fsSL https://prompt.asadshah.co.uk/mac/uninstall_public.sh | bash
```

It stops the helper and removes it from this Mac. Claude Code and iTerm2 are left as they are. The user can then delete the Prompt app from their iPhone.