thinkpool-pair 0.6.11 → 0.6.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -51,6 +51,29 @@ every byte mirrors to the web. The web's **"+ New terminal"** spawns additional
|
|
|
51
51
|
**headless** terminals here (same directory, same env), driven entirely from
|
|
52
52
|
the room. One bridge, many terminals.
|
|
53
53
|
|
|
54
|
+
## Run it in the cloud (remote host / VM / container)
|
|
55
|
+
|
|
56
|
+
The bridge connects **outbound** to Supabase — no inbound ports, no public IP, no
|
|
57
|
+
tunnel. So a cloud VM, container, devcontainer, or remote dev box can stream its
|
|
58
|
+
Claude Code into the room exactly like a laptop. Run the same command there:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
export ANTHROPIC_API_KEY=sk-ant-... # headless auth (no Keychain login)
|
|
62
|
+
cd /path/to/your/repo
|
|
63
|
+
npx thinkpool-pair <ROOM> -- claude # structured Claude, no TTY needed
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
- **Auth**: set `ANTHROPIC_API_KEY` (or `CLAUDE_CODE_OAUTH_TOKEN`) in the box's
|
|
67
|
+
env — the Agent SDK reads it automatically. The structured path runs the SDK's
|
|
68
|
+
bundled `claude`, so you don't need Claude Code separately installed.
|
|
69
|
+
- **No TTY required**: the agent picker auto-selects and raw-mode is skipped when
|
|
70
|
+
there's no terminal, so it runs fine under CI / a service / `nohup`.
|
|
71
|
+
- **Always-on**: `npx thinkpool-pair install-service <ROOM> -- claude` installs a
|
|
72
|
+
systemd `--user` unit (auto-restart + boot-persistent + auto-update). On a
|
|
73
|
+
server, also run `loginctl enable-linger $USER` so it survives logout.
|
|
74
|
+
- **Security**: anyone with the room code can drive the agent (shell-trust by
|
|
75
|
+
design) — on a server that's a real shell, so treat the room code like a secret.
|
|
76
|
+
|
|
54
77
|
## How it works
|
|
55
78
|
|
|
56
79
|
`bridge.mjs` ⇄ **Supabase realtime** (`tpcode:<ROOM>`) ⇄ web `xterm`:
|