Handback

For people who run coding agents

Your agent needs
a sign-in.
Handback puts it
in your hand.

Coding agents and command-line tools open sign-ins and links on the computer they run on — often one you aren't looking at, so the login just waits. Handback hands them to the iPhone, iPad or Mac in front of you.

$7.99 / €7.99 · Mac, iPhone & iPad, one purchase

✓ logged in on agent-box

“A browser just opened on a machine I can't see.”

Coding agents, command-line tools and remote dev boxes constantly try to open URLs in a browser nobody's looking at — and worse, OAuth flows redirect to localhost on that box, so the login hangs forever. Handback fixes both.

  1. 01

    It starts where you aren't looking

    codex login on your Mac in Engine mode — or on a Linux box — wants a browser, and waits for the sign-in to call back to localhost:1455.

  2. 02

    The link lands on your phone

    Or on your Mac or iPad: the Engine hands it to the app on your devices, and it's logged in that machine's history.

  3. 03

    You sign in, in the app

    The sign-in page opens right there — in an in-app sheet on the iPhone, in your browser on the Mac.

  4. 04

    The callback goes home

    The app catches the localhost redirect and tunnels it back to the box. The terminal carries on.

See it work

One login, start to finish.

codex login on a box, the sign-in on the phone, the terminal carrying on — then every link in the Mac app's history.

45 s · Codex login handed back
Recorded on a real iPhone and a Mac. The sign-in is a demo page — no real account.

$7.99 / €7.99 · Mac, iPhone & iPad, one purchase

Peer to peer

Nothing in the middle.

The Engine on the box catches the link and hands it to the app on your device. When a CLI's sign-in redirects to localhost on the box, the app binds that port on your device and tunnels the callback back — so headless logins actually complete.

How Handback connects Inside your network, the free Handback Engine on the box hands the link over the tailnet, LAN or a secure WebSocket to the Handback app on your Mac, iPhone or iPad, with no relay in between. When the sign-in redirects to localhost, the app binds that port on the device and tunnels the callback back to the box's localhost. YOUR NETWORK agent-box the box you can't see handback engine codex waits on :1455 Mac · iPhone · iPad your devices Handback app binds localhost:1455 01 the link tailnet · LAN · wss no relay in between 02 the OAuth callback, tunneled back from the device's loopback How Handback connects Inside your network, the free Handback Engine on the box hands the link to the Handback app on your devices with no relay in between, and the app tunnels the OAuth callback from the device's localhost back to the box. YOUR NETWORK agent-box the box you can't see handback engine codex waits on :1455 Mac · iPhone · iPad your devices Handback app binds localhost:1455 01 the link tailnet · LAN · wss no relay in between 02 the callback
No relay
Your machines talk directly. There's no relay we run — nothing in the middle to leak, and no monthly bill to pass on. That's why it's a one-time price.
No account
No Handback server, no sign-up. Your link history — links can carry auth codes — stays on your devices, and the Engine's controls answer only on its own machine.
Your network
A Tailscale tailnet (recommended) or a trusted LAN over plain ws://, or wss:// through a TLS proxy in front of the box. The app dials out, so your laptop can roam.

More than an opener

A private, local-first dashboard of every link your machines hand back.

Handback on iPhone, the Machines list: agent-box online with 5 links, build-vm offline with none. Handback on iPhone, the Machines list: agent-box online with 5 links, build-vm offline with none.
Handback on iPhone, the agent-box history: an auth.openai.com sign-in waiting for its callback on port 1455, a GitHub pull request, a Google sign-in completed on agent-box, and a GitHub device login that arrived while you were away. Handback on iPhone, the agent-box history: an auth.openai.com sign-in waiting for its callback on port 1455, a GitHub pull request, a Google sign-in completed on agent-box, and a GitHub device login that arrived while you were away.

Every machine, one place

Connect all your agentic boxes. Each one's links land in its own history — stored on your device. Auto-open per machine, or just capture and notify.

Settings · Engine
Handback on the Mac, Settings → Engine: devices connect to the Tailscale address, detected 100.101.7.42 and confirmed; status Running, listening on 100.101.7.42:8765, one device connected (a MacBook Air), nothing queued; below, the Default browser setting with Make Handback the default browser. Handback on the Mac, Settings → Engine: devices connect to the Tailscale address, detected 100.101.7.42 and confirmed; status Running, listening on 100.101.7.42:8765, one device connected (a MacBook Air), nothing queued; below, the Default browser setting with Make Handback the default browser.

Engine mode on the Mac

Agents on a Mac? The app runs the Engine itself and can become the default browser: links opened by terminals and agents are handed back, your own clicks open locally.

Handback on iPhone: the system prompt “Handback” Wants to Use “claude.ai” to Sign In, with Cancel and Continue, over a claude.ai link from agent-box waiting for its sign-in callback on port 54545. Handback on iPhone: the system prompt “Handback” Wants to Use “claude.ai” to Sign In, with Cancel and Continue, over a claude.ai link from agent-box waiting for its sign-in callback on port 54545.

Loopback callbacks that finish

OAuth CLIs redirect to localhost on the box — unreachable from your laptop. Handback tunnels the callback back, so headless logins actually complete.

Up and running in a minute

On a Mac, Handback runs the Engine itself — turn it on, pair your phone, done. For a Linux or headless box, the Engine is a free one-line install.

  1. 01

    Turn on Engine mode

    On the Mac your agents run on, open Handback → Settings → Engine and turn it on. For a Linux or headless box, install the free Engine instead.

  2. 02

    Pair your devices

    Scan the pairing QR with your iPhone or iPad, or paste its link into Handback on another Mac. Once.

  3. 03

    Get your links back

    Links your terminals and agents open land on the device in your hand. Sign in there and the login finishes.

Full guide in the docs.

Mac

Open Handback → Settings → Engine

Turn on “Act as an engine on this Mac,” confirm your tailnet address, then Show pairing QR… and scan it with your iPhone or iPad. Nothing else to install.

Linux / headless box
# install the free Engine
curl -fsSL https://gethandback.com/install.sh | sh

# catch links + pair your devices
handback install
handback pair --host your-box:8765 --qr

# keep it running (systemd user unit / LaunchAgent)
handback service install

One price. Every device.

Mac, iPhone & iPad on one purchase. Glance from the menu bar, or pick up where you left off on your phone.

Handback · one-time

On the box

The Engine

Free

Built into the Mac app · Linux & macOS one-line install

On your devices

The Handback app

$7.99 / €7.99

One purchase, not a subscription.

  • Mac, iPhone & iPad (universal)
  • Unlimited machines & link history
  • Loopback OAuth callback tunnel
  • Free updates

$7.99 / €7.99 · Mac, iPhone & iPad, one purchase

Questions, answered

Do I need to install anything on my Mac?

No. On a Mac, Handback is the Engine: Settings → Engine runs it for you, can start it at login if you choose, listens on your tailnet address once you confirm it, and can become the default browser — links opened by terminals and agents are handed to your other devices, your own clicks open in your usual browser. Ran the command-line Engine there before? Import its pairing and your devices keep working.

And on a Linux or headless box?

Install the Engine: a free single binary for Linux (x86_64 and arm64) and macOS, installed with one command and kept running as a systemd user service or a LaunchAgent. It catches links through $BROWSER and xdg-open on Linux, and on a headless Mac through a default-browser helper — so gh, gcloud and agents that call open are all caught.

Do my machines need to be on the same network?

No. The app dials out to each Engine, so your laptop can roam. Put both on a Tailscale tailnet (recommended) or a LAN you trust, where plain ws:// is fine, or put a TLS reverse proxy in front of the box and pair over wss://. There's no relay either way.

Why do headless OAuth logins hang without Handback?

CLI logins redirect the browser to localhost on the box (RFC 8252). If the browser is on your laptop, that localhost is the wrong machine — the code never arrives. Handback binds the port on your device and tunnels the callback back to the box, so the login just finishes. On an iPhone the sign-in opens in an in-app sheet; on a Mac, in your browser. How to finish one by hand.

Where does my link history live?

On your devices. There's no Handback server and no account — links (which can carry auth codes) never touch infrastructure you don't own.

What happens if my phone is off when a link arrives?

The Engine keeps it. Links that arrive while no device is connected stay on that machine for 24 hours and are delivered when a device connects, marked “arrived while you were away” — they're never opened automatically. The terminal on the box also prints the link, so you can open it there.

Why one-time pricing?

Because there's nothing for us to keep running. Your machines talk peer-to-peer; no relay, no sync service, no monthly bill to pass on. One purchase covers Mac, iPhone and iPad, and the Engine is free.

Let the login finish.

Handback for Mac, iPhone & iPad. Turn on Engine mode, pair your phone, and the next sign-in your agent opens is in your hand.

$7.99 / €7.99 · Mac, iPhone & iPad, one purchase