thinkpool-pair 0.6.10 → 0.6.12

package/README.md

@@ -35,6 +35,9 @@ The bridge self-heals at three levels — all cross-platform (macOS / Linux / Wi
   npx thinkpool-pair install-service <ROOM> -- claude   # set and forget
   npx thinkpool-pair uninstall-service <ROOM>           # remove it
   ```
+  The service runs `npx thinkpool-pair@latest`, so it **auto-updates** — new
+  versions apply on the next restart, no re-install. (Linux: run
+  `loginctl enable-linger $USER` once to keep it running after logout.)
 - **Watchdog** — if the realtime channel wedges for >60s, the bridge exits so the
   supervisor/service restarts a clean process. Brief network blips reconnect on
   their own.
@@ -48,6 +51,29 @@ every byte mirrors to the web. The web's **"+ New terminal"** spawns additional
 **headless** terminals here (same directory, same env), driven entirely from
 the room. One bridge, many terminals.
 
+## Run it in the cloud (remote host / VM / container)
+
+The bridge connects **outbound** to Supabase — no inbound ports, no public IP, no
+tunnel. So a cloud VM, container, devcontainer, or remote dev box can stream its
+Claude Code into the room exactly like a laptop. Run the same command there:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...          # headless auth (no Keychain login)
+cd /path/to/your/repo
+npx thinkpool-pair <ROOM> -- claude          # structured Claude, no TTY needed
+```
+
+- **Auth**: set `ANTHROPIC_API_KEY` (or `CLAUDE_CODE_OAUTH_TOKEN`) in the box's
+  env — the Agent SDK reads it automatically. The structured path runs the SDK's
+  bundled `claude`, so you don't need Claude Code separately installed.
+- **No TTY required**: the agent picker auto-selects and raw-mode is skipped when
+  there's no terminal, so it runs fine under CI / a service / `nohup`.
+- **Always-on**: `npx thinkpool-pair install-service <ROOM> -- claude` installs a
+  systemd `--user` unit (auto-restart + boot-persistent + auto-update). On a
+  server, also run `loginctl enable-linger $USER` so it survives logout.
+- **Security**: anyone with the room code can drive the agent (shell-trust by
+  design) — on a server that's a real shell, so treat the room code like a secret.
+
 ## How it works
 
 `bridge.mjs` ⇄ **Supabase realtime** (`tpcode:<ROOM>`) ⇄ web `xterm`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thinkpool-pair",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "description": "Share a local coding-agent CLI (Claude Code, Codex, Gemini, Aider, …) into a ThinkPool Code room, live.",
   "type": "module",
   "bin": {

package/service.mjs

@@ -12,24 +12,34 @@
 import os from 'node:os'
 import fs from 'node:fs'
 import path from 'node:path'
-import { fileURLToPath } from 'node:url'
 import { execSync } from 'node:child_process'
 
-const BRIDGE = fileURLToPath(new URL('./bridge.mjs', import.meta.url))
 const label = (room) => `io.thinkpool.pair.${room.toLowerCase()}`
 const xml = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
 
+// Resolve the real npx next to the current node, so the service stays seamless:
+// it runs `npx -y thinkpool-pair@latest …`, always picking up the newest publish
+// with no re-install. Absolute path + injected PATH so it works under launchd /
+// systemd's bare environment (which don't search PATH for argv[0]).
+function npxPath(platform) {
+  const bin = path.dirname(process.execPath)
+  const cand = path.join(bin, platform === 'win32' ? 'npx.cmd' : 'npx')
+  try { fs.accessSync(cand); return cand } catch { return platform === 'win32' ? 'npx.cmd' : 'npx' }
+}
+
 // Pure artifact builder — returned shape is testable without side effects.
-// `mode:'service'` lets the OS supervise (no --supervise); 'supervise' wraps it.
 export function buildArtifact(platform, { room, cmdArgs = [] }) {
-  const node = process.execPath
+  const npx = npxPath(platform)
   const cwd = process.cwd()
   const logDir = path.join(os.homedir(), '.thinkpool-pair')
   const log = path.join(logDir, `${room}.log`)
   const tail = cmdArgs.length ? ['--', ...cmdArgs] : []
+  // OS-supervised tiers (launchd KeepAlive / systemd Restart) don't need
+  // --supervise; the latest published bridge is fetched by npx each (re)start.
+  const pkgArgs = ['-y', 'thinkpool-pair@latest', room]
 
   if (platform === 'darwin') {
-    const args = [node, BRIDGE, room, ...tail]   // launchd KeepAlive supervises
+    const args = [npx, ...pkgArgs, ...tail]   // launchd KeepAlive supervises
     const file = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label(room)}.plist`)
     const content = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -47,7 +57,7 @@ export function buildArtifact(platform, { room, cmdArgs = [] }) {
   }
 
   if (platform === 'linux') {
-    const args = [node, BRIDGE, room, ...tail]   // systemd Restart=always supervises
+    const args = [npx, ...pkgArgs, ...tail]   // systemd Restart=always supervises
     const file = path.join(os.homedir(), '.config', 'systemd', 'user', `${label(room)}.service`)
     const content = `[Unit]
 Description=ThinkPool Code bridge (${room})
@@ -73,7 +83,8 @@ WantedBy=default.target
     // running --supervise gives login-persistence + crash-restart, dependency-free.
     const startup = path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup')
     const file = path.join(startup, `thinkpool-pair-${room}.cmd`)
-    const inner = [`"${node}"`, `"${BRIDGE}"`, room, '--supervise', ...tail].join(' ')
+    // Startup folder isn't a supervisor → keep --supervise for crash-restart.
+    const inner = ['npx', '-y', 'thinkpool-pair@latest', room, '--supervise', ...tail].join(' ')
     const content = `@echo off\r\ntitle thinkpool-pair ${room}\r\n${inner}\r\n`
     return { file, content, logDir, post: [], note: 'Installed to the Startup folder — runs at login with --supervise (auto-restart on crash). Start it now without rebooting by double-clicking the .cmd, or run it from a terminal.' }
   }
@@ -90,7 +101,7 @@ export function installService(room, cmdArgs = []) {
   for (const cmd of a.post) {
     try { execSync(cmd, { stdio: 'inherit' }) } catch (e) { process.stderr.write(`  ⚠ "${cmd}" failed: ${e.message}\n`) }
   }
-  process.stderr.write(`  ◆ ${a.note}\n  ◆ logs: ${path.join(a.logDir, `${room}.log`)}\n  ◆ remove with: thinkpool-pair uninstall-service ${room}\n\n`)
+  process.stderr.write(`  ◆ ${a.note}\n  ◆ tracks thinkpool-pair@latest — new versions apply on next restart, no re-install.\n  ◆ logs: ${path.join(a.logDir, `${room}.log`)}\n  ◆ remove with: thinkpool-pair uninstall-service ${room}\n\n`)
 }
 
 export function uninstallService(room) {