help
Support
Getting JoeBro running on the Mac, pairing the iPhone, and what to do when something won't connect.
joe · updated 22 november 2026 · joebro 1.6
install
One command installs the Mac app and plugs it into Claude Code, Codex and OpenCode. It needs macOS 26 or later.
curl -fsSL https://joebro.pages.dev/install.sh | bash
Or download the DMG from GitHub releases. The app is signed and notarised, and updates itself.
just looking?
On the iPhone app's first screen, tap Try the demo. It loads sample data with no Mac and no network. Leave it from Settings with Leave the demo.
pair the iPhone
- On the Mac, open Settings → Mobile and turn on Let my phone connect.
- Scan the QR code from the phone, or paste the link or address and token by hand.
- Away from home, use Tailscale on both devices.
if it won't connect
- Check the Mac is awake and JoeBro is open.
- Check both devices are on the same Wi-Fi, or both on Tailscale.
- If the token was not accepted, scan a fresh QR code.
- In iPhone Settings, allow JoeBro to use the local network.
- On the Mac, Test from this Mac under Settings → Mobile, and check the firewall.
coding agents not showing up?
- Run the install command again. It's safe to re-run, and it re-links your agents.
- Restart any agent sessions that were open during the install.
contact and bugs
Open an issue on GitHub. Never post tokens or pairing links. See also the privacy page.