Wrapper supports macOS and Linux. On Windows, use WSL.
Install the CLI
Homebrew
If Homebrew reports that Xcode is outdated, update Command Line Tools or use the
curl installer below. The formula only unpacks a release binary; it does not
build Wrapper with Xcode. See Troubleshooting.
Checksum-verified installer
The installer downloads a release tarball from GitHub Releases, verifies
checksums.txt, and installs under $HOME/.wrapper (override with
WRAPPER_INSTALL_DIR). Optional pins:
Confirm:
Update the CLI
Update with the same method you used to install.
Homebrew:
Curl installer:
Do not mix the two. The curl installer prepends $HOME/.wrapper/bin to PATH,
so that copy wins over Homebrew. After brew upgrade, wrapper --version can
still show the older curl binary. Check with which -a wrapper. See
Troubleshooting.
Get iOS viewer beta
The iPhone and iPad app is a TestFlight viewer, not a host. The shell, files,
and credentials stay on the Mac or Linux machine. After the CLI is installed
and a session is shared, attach from iOS.
See Mobile viewer.
Share a session
wrapper share does not patch your shell config:
Wrap a command without sharing yet:
Prefer a remote Linux box? See Remote Linux box.
Optional: wrap every new terminal
wrapper install is optional. It adds a line to your shell config so every new
interactive shell is wrapped. Sharing does not need this.
Sign in
Remote share needs a Wrapper account. Local attach uses the loopback token
only:
Approve the device code at the printed URL. Check status with
wrapper auth whoami.
See Authentication for token storage and logout.
Attach locally
From another terminal on the same machine:
Local attach uses loopback plus a per-session token from your session registry.
It does not use the Fly relay, Convex, or Pro.
See Local attach.
Share remotely (Pro)
wrapper share shares immediately. In a running host, press Ctrl+\ then s.
Wrapper prints a share code and join command when the shell is idle.
Owner join from any device:
Guest join uses the same command and a hidden share-code prompt. Press
Ctrl+\ then u to revoke access.
People you invite see the screen. They cannot type unless you allow it.
