Set up Wrangle

Get the app

Install Wrangle on your iPhone and open it. It is free to start.

Install the helper

Run this in Terminal on your Mac. It downloads the helper to ~/.wrangle/bin, checks it, and starts setup.

Want to look first? Read the install script, or build the helper yourself from the source on GitHub.

Pair your phone

Setup shows a QR code in Terminal. In the app, open Computers, tap +, and scan it.

No camera handy? Type the six-character code shown under the QR code instead.

Turn on Remote Login

The terminal and chat view connect to your Mac over SSH. Turn on Remote Login in System Settings → General → Sharing. Setup checks this for you.

They also use tmux:

Away from home

Approvals reach your Lock Screen anywhere. For the terminal and chat away from your Wi-Fi, install Tailscale on your Mac and your iPhone.

Something not working?

Run this. It checks every part of the setup and tells you what to fix.

Still stuck? Email [email protected].

Uninstall

This removes Wrangle’s hooks and background service. The rest of your Claude Code and Codex settings stay as they were.