buildscroll

Remote terminal over WebSocket.

Run a command on your machine. Scan a QR code.
Get a fullscreen terminal on your phone.

No SSH. No port forwarding. No config files.

$ getting started

1

Install

brew install lfsmoura/tap/buildscroll
2

Run

buildscroll

Spawns claude by default. Use --command /bin/zsh for a shell.

3

Scan

A QR code appears in your terminal. Scan it with your phone. You're in.

$ how it works

┌──────────────┐       ┌──────────────┐       ┌──────────────┐
│   your mac   │──WS──▶│  cloudflare  │◀──WS──│  your phone  │
│   (bridge)   │       │   (relay)    │       │  (xterm.js)  │
└──────────────┘       └──────────────┘       └──────────────┘
     PTY ↕                passthrough              browser
  ┌──────────┐
  │ claude / │
  │  shell   │
  └──────────┘

transport

Binary WebSocket frames. PTY I/O piped directly through a Cloudflare relay.

auth

Random token in the URL #fragment — never sent to the server in HTTP requests.

latency

Cloudflare edge. The relay is a Durable Object — your session lives close to you.

terminal

xterm.js in the browser. Full ANSI support. Resize events propagate back to the PTY.

$ examples

# spawn a shell
buildscroll --command /bin/zsh

# run htop remotely
buildscroll --command htop

# use a different relay
buildscroll --relay https://my-relay.example.com