Rabbitty Download

From Your Phone

Your agents keep working after you close the laptop. Remote access lets you open Rabbitty on your phone, see what every agent is doing, and answer the ones that are stuck on you — then put the phone away again.

It is off by default. Nothing is reachable until you turn it on.

What you get

  • The inbox. Whoever needs you first, at the top. Below that, everything else — grouped by project and worktree exactly the way the sidebar groups it.
  • Reply to any agent. Not only the ones that stopped to ask a question. Tap through to a pane, read its screen, and type.
  • The terminal, readable on a phone. Text in the terminal's own colours and weights, wrapped to the phone's width — or switched to fit to terminal when the shape of the output is the content.
  • Send a photo. Attach a screenshot from your camera roll and hand it to the agent.
  • Wrap up a worktree from wherever you are.

Turn it on

1. Open the card. Press ⌘⇧P and choose Connect from your phone.

2. Press Turn on. Wait for the row to read Phone link is up. Your Mac dials out to Rabbitty's relay — no port is opened on your Mac, and there is nothing to configure on your router.

3. Press Pair a device and scan the QR. Point your phone's camera at the code and open the link. There is nothing to type. The page will pair itself and land on your workspaces.

4. Bookmark it. Add it to your home screen. That phone stays paired; you only scan once.

Turn it off

Press Turn off on the same card, and the link closes. Every paired device is listed there too — Revoke ends one device's access without touching the others.

Keeping the Mac awake

An asleep Mac answers nothing. Rabbitty tells you if yours is free to sleep, but it does not insist — how you handle it is your call:

  • caffeinate -s in a terminal (the card's Keep awake button runs exactly this, in a visible tab you can close to release it),
  • an app like Amphetamine,
  • or System Settings ▸ Battery.

A closed lid sleeps regardless. For always-on, use a machine that stays open.

Is this private?

Yes, and it is worth being precise about what that means.

Your phone and your Mac agree on a key when you scan the QR, and everything between them is sealed with it. The relay in the middle forwards ciphertext it cannot read — it is a post box, not a reader. Your terminal output, your prompts, and your replies are never readable by the relay, by Rabbitty, or by us.

Two more properties worth knowing:

  • Both ends dial out. Nothing listens for inbound connections on your Mac, so turning this on does not expose a port.
  • Pairing is one-shot. The QR carries a bootstrap that buys exactly one pairing and is spent the moment your phone uses it. Someone who photographs your screen a minute later gets nothing.

From a shell instead

If you would rather use SSH, the rab command drives the same panes from any terminal — including one on your phone:

rab                 # every pane, and what each agent is doing
rab attention       # only the ones blocked on you
rab read 2 -n 40    # the last 40 lines of pane 2
rab send 2 yes go   # type into pane 2, then Enter
rab attach 2        # a live view with a compose line

Run rab doctor to check what is set up and what isn't.

If something isn't working

Run rab doctor — it checks each piece and names the one that is wrong rather than making you guess.

  • "Phone link is off" — press Turn on and give it a few seconds.
  • The row is red and names a network error — your Mac cannot reach the relay. A VPN or a corporate DNS resolver is the usual cause. The row quotes the exact error it hit.
  • "Can't pair" — the Mac refuses to hand out a code while it cannot reach the relay, because your phone would scan it and wait for an answer that never comes. Fix the link first; the row above says what it hit.