Setup

Set up Wrangle

About two minutes. You need an iPhone and a Mac with Claude Code or Codex installed.

01

Get the app

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

Download on the App Store
02

Install the helper

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

curl -fsSL https://wrangle.stackframes.dev/install | sh

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

03

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.

04

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:

brew install tmux
05

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.

wrangle doctor

Still stuck? Email contact@stackframes.dev.

Uninstall

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

wrangle uninstall