thinkpool-pair 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# thinkpool-pair — the ThinkPool Code bridge
+
+Share your local **Claude Code** (or any terminal CLI) into a ThinkPool Code
+room, live. Both people see the real terminal stream and can both drive it —
+no copy/paste.
+
+> A web page can't read your terminal directly (browser security). This tiny
+> helper is the bridge: it runs the CLI in a PTY and streams it to the room.
+
+## Run it (one command)
+
+```bash
+cd bridge && npm i        # one-time (builds node-pty — needs Xcode CLT / build-essential)
+node bridge.mjs <ROOM>    # launches `claude`, shared into room <ROOM>
+```
+
+- `<ROOM>` is the 5-char room code from the ThinkPool Code web UI (`/code`).
+- Share any other CLI: `node bridge.mjs <ROOM> -- aider`  /  `… -- bash`.
+- Use the terminal exactly as normal — it's seamless locally, and every byte
+  mirrors to the web for your partner. Prompts/keys typed in the web come back
+  into your session.
+
+## How it works
+
+`bridge.mjs` ⇄ **Supabase realtime** (`tpcode:<ROOM>`) ⇄ web `xterm`:
+- `pty-out` — terminal bytes (base64) → both web clients render them.
+- `pty-in`  — keystrokes/prompts from the web → written to your PTY.
+- `resize`  — web viewport size → `term.resize`.
+
+Public anon creds are embedded (the same ones the web app ships). Override with
+`TP_SUPABASE_URL` / `TP_SUPABASE_ANON` if needed. Set `TP_NAME` to label yourself.

package/bridge.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/* ─────────────────────────────────────────────────────────────
+   thinkpool-pair — share your local Claude (or any CLI) into a
+   ThinkPool Code room, live. ONE command, seamless:
+
+     npx thinkpool-pair <ROOM>            # launches `claude`, shared
+     npx thinkpool-pair <ROOM> -- <cmd…>  # share any other CLI
+
+   It spawns the CLI in a PTY so you use it exactly like your normal
+   terminal — and every byte streams to the room over Supabase realtime
+   (the relay), while prompts/keys from the web come back into the PTY.
+   No copy/paste. A web page can't read your terminal directly — this
+   tiny helper is the bridge.
+   ───────────────────────────────────────────────────────────── */
+
+import os from 'node:os'
+import { createClient } from '@supabase/supabase-js'
+
+// Public client creds (the same anon values the web app ships — safe to embed).
+// Override with TP_SUPABASE_URL / TP_SUPABASE_ANON if you ever need to.
+const SUPABASE_URL  = process.env.TP_SUPABASE_URL  || 'https://daytvtakmlixpfbbqzjd.supabase.co'
+const SUPABASE_ANON = process.env.TP_SUPABASE_ANON || 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRheXR2dGFrbWxpeHBmYmJxempkIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzgwNTMxNzEsImV4cCI6MjA5MzYyOTE3MX0.zYmz8bHUNEY4STUr2JuXChAsKwxNwkwFHe1Hd0Betqo'
+
+// node-pty is a native module — loaded lazily so a friendly message shows
+// if it isn't built yet.
+let pty
+try { pty = (await import('node-pty')).default ?? (await import('node-pty')) }
+catch {
+  console.error('\n  node-pty isn\'t installed. From the bridge folder run:\n    npm i\n  then re-run.  (it needs a C toolchain — Xcode CLT on mac, build-essential on linux)\n')
+  process.exit(1)
+}
+
+const argv = process.argv.slice(2)
+const room = (argv[0] || '').toUpperCase().trim()
+if (!room) { console.error('usage: npx thinkpool-pair <ROOM> [-- <command…>]'); process.exit(1) }
+const dashIdx = argv.indexOf('--')
+const [cmd, ...cmdArgs] = dashIdx >= 0 ? argv.slice(dashIdx + 1) : ['claude']
+const name = process.env.TP_NAME || os.userInfo().username || 'host'
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_ANON, {
+  realtime: { params: { eventsPerSecond: 60 } },
+})
+const channel = supabase.channel(`tpcode:${room}`, {
+  config: { broadcast: { self: false }, presence: { key: `bridge:${name}` } },
+})
+
+// ── spawn the CLI in a PTY; the host uses it like a normal terminal ──
+const cols = process.stdout.columns || 100
+const rows = process.stdout.rows || 30
+const term = pty.spawn(cmd || 'claude', cmdArgs, {
+  name: 'xterm-256color', cols, rows, cwd: process.cwd(), env: process.env,
+})
+
+// host's own keystrokes → the CLI (so it's seamless locally too)
+if (process.stdin.isTTY) process.stdin.setRawMode(true)
+process.stdin.resume()
+process.stdin.on('data', d => term.write(d.toString('utf8')))
+
+// CLI output → host's screen + batched out to the room
+let buf = ''
+term.onData(d => { process.stdout.write(d); buf += d })
+const flush = () => {
+  if (!buf) return
+  const b64 = Buffer.from(buf, 'utf8').toString('base64'); buf = ''
+  channel.send({ type: 'broadcast', event: 'pty-out', payload: { b64 } })
+}
+const flushTimer = setInterval(flush, 35)
+
+const announce = () =>
+  channel.send({ type: 'broadcast', event: 'bridge', payload: { name, cmd: cmd || 'claude', cols, rows } })
+
+channel
+  .on('broadcast', { event: 'pty-in' }, ({ payload }) => { if (payload?.data) term.write(payload.data) })
+  .on('broadcast', { event: 'resize' }, ({ payload }) => {
+    if (payload?.cols && payload?.rows) { try { term.resize(payload.cols, payload.rows) } catch { /* noop */ } }
+  })
+  .on('broadcast', { event: 'who' }, announce)
+  .subscribe(status => {
+    if (status === 'SUBSCRIBED') {
+      channel.track({ name, role: 'bridge' })
+      announce()
+      process.stderr.write(`\n  ◆ thinkpool — sharing "${cmd || 'claude'}" into room ${room}.  Open the web UI and you're both in.\n\n`)
+    }
+  })
+
+const shutdown = () => {
+  clearInterval(flushTimer)
+  try { channel.send({ type: 'broadcast', event: 'pty-out', payload: { b64: Buffer.from('\r\n[ shared session ended ]\r\n', 'utf8').toString('base64') } }) } catch { /* noop */ }
+  try { supabase.removeChannel(channel) } catch { /* noop */ }
+  try { term.kill() } catch { /* noop */ }
+  process.exit(0)
+}
+term.onExit(shutdown)
+process.on('SIGINT', shutdown)
+process.on('SIGTERM', shutdown)

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "thinkpool-pair",
+  "version": "0.1.0",
+  "description": "Share your local Claude (or any CLI) into a ThinkPool Code room, live.",
+  "type": "module",
+  "bin": "bridge.mjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.45.0",
+    "node-pty": "^1.0.0"
+  }
+}