codeam-cli 2.4.12 → 2.4.14

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.13] — 2026-05-03
+
+### Fixed
+
+- **cli:** Codeam pair survives SSH disconnect for codeam deploy (v2.4.13)
+
+## [2.4.12] — 2026-05-03
+
+### Fixed
+
+- **cli:** Wait for Claude to be ready before closing local terminal (v2.4.12)
+
+## [2.4.11] — 2026-05-03
+
+### Fixed
+
+- **cli:** Codeam deploy detaches local terminal after pairing (v2.4.11)
+
 ## [2.4.10] — 2026-05-03
 
 ### Fixed

package/dist/index.js

@@ -179,7 +179,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.4.12",
+  version: "2.4.14",
   description: "Remote control Claude Code (and other AI coding agents) from your mobile phone. Pair your device, send prompts, stream responses in real-time, and approve commands \u2014 from anywhere.",
   main: "dist/index.js",
   bin: {
@@ -706,6 +706,7 @@ def onwinch(n,f):
     except Exception:pass
 signal.signal(signal.SIGCHLD,onchld)
 signal.signal(signal.SIGWINCH,onwinch)
+signal.signal(signal.SIGHUP,signal.SIG_IGN)
 i=sys.stdin.fileno()
 o=sys.stdout.fileno()
 while not done[0]:
@@ -5890,47 +5891,48 @@ async function deploy() {
     ].filter(Boolean).join("\n"),
     "Almost there"
   );
-  const wrapperLines = [
+  const wrapper = [
     "mkdir -p ~/.codeam-deploy",
     "LOG=~/.codeam-deploy/session.log",
-    "PIDFILE=~/.codeam-deploy/session.pid",
-    // Stop any prior detached session for this codespace.
-    'if [ -f "$PIDFILE" ]; then OLD=$(cat "$PIDFILE" 2>/dev/null); if [ -n "$OLD" ] && kill -0 "$OLD" 2>/dev/null; then kill "$OLD" 2>/dev/null; sleep 1; fi; fi',
     ': > "$LOG"',
-    // Detach codeam pair from this shell so SSH hangup and Ctrl+C
-    // can never reach it.
-    'nohup codeam pair > "$LOG" 2>&1 < /dev/null &',
-    "PID=$!",
-    "disown",
-    'echo "$PID" > "$PIDFILE"',
-    // Stream the log to the local terminal.
-    'tail -n +1 -F "$LOG" 2>/dev/null &',
+    // The default `gh codespace ssh` cwd is the repo root
+    // (/workspaces/<repo>), which is exactly where Claude needs to
+    // run so it can read/edit project files. Pass that to PM2 via
+    // --cwd so the relay's child Claude inherits the right
+    // working directory.
+    'PROJECT_DIR="$(pwd)"',
+    // Install PM2 if it isn't already on PATH. Idempotent.
+    "if ! command -v pm2 >/dev/null 2>&1; then",
+    '  echo "Installing pm2 (one-time setup)\u2026"',
+    '  npm install -g pm2 >/dev/null 2>&1 || { echo "\u2717 Failed to install pm2"; exit 1; }',
+    "fi",
+    // Stop any prior codeam-pair instance — fresh start each deploy.
+    "pm2 delete codeam-pair >/dev/null 2>&1",
+    // Start codeam pair under PM2. `--merge-logs` writes stdout
+    // and stderr to the same file so we only need one tail.
+    'pm2 start codeam --name codeam-pair --cwd "$PROJECT_DIR" -o "$LOG" -e "$LOG" --merge-logs --time -- pair >/dev/null 2>&1',
+    'tail -n 0 -F "$LOG" 2>/dev/null &',
     "TAIL=$!",
-    // Local Ctrl+C: kill ONLY the tail and exit — relay stays alive.
     "trap 'kill $TAIL 2>/dev/null; exit 130' INT TERM",
-    // Phase 1 — wait for the QR scan to complete.
+    // Phase 1 — wait for "Paired with".
     "SUCCESS=0",
     "while true; do",
     '  if grep -q "Paired with" "$LOG" 2>/dev/null; then SUCCESS=1; break; fi',
-    '  if ! kill -0 "$PID" 2>/dev/null; then SUCCESS=0; break; fi',
+    `  STATUS=$(pm2 jlist 2>/dev/null | grep -o '"name":"codeam-pair","[^}]*"status":"[^"]*"' | grep -o '"status":"[^"]*"' | head -1)`,
+    '  if [ -z "$STATUS" ]; then SUCCESS=0; break; fi',
+    '  if echo "$STATUS" | grep -q "stopped\\|errored"; then SUCCESS=0; break; fi',
     "  sleep 1",
     "done",
     'if [ "$SUCCESS" = "1" ]; then',
     "  echo",
     '  echo "\u2713 Phone paired."',
-    '  echo "  Claude may ask first-time prompts ("trust this folder", model picker, etc.) \u2014 answer those on your phone."',
-    '  echo "  This terminal will disconnect once Claude is fully ready, or press Ctrl+C now to disconnect immediately."',
+    '  echo "  Answer any first-time prompts ("trust this folder", etc.) on your phone."',
+    '  echo "  Local terminal will close once Claude is ready."',
     "  echo",
-    // Phase 2 — wait until Claude is fully initialised. The
-    // "? for shortcuts" line (from Claude\'s status bar) is the most
-    // reliable "ready" marker — it only renders AFTER any trust /
-    // onboarding prompts have been resolved. Cap at 3 minutes so we
-    // never hang the local terminal forever if the user doesn\'t
-    // resolve a prompt on their phone.
+    // Phase 2 — wait for the Claude "ready" marker.
     "  WAIT_START=$(date +%s)",
     "  while true; do",
     '    if grep -q "for shortcuts" "$LOG" 2>/dev/null; then break; fi',
-    '    if ! kill -0 "$PID" 2>/dev/null; then break; fi',
     "    if [ $(($(date +%s) - WAIT_START)) -gt 180 ]; then break; fi",
     "    sleep 1",
     "  done",
@@ -5939,21 +5941,22 @@ async function deploy() {
     "kill $TAIL 2>/dev/null",
     "echo",
     'if [ "$SUCCESS" = "1" ]; then',
-    '  echo "\u2713 Session running on codespace (PID $PID). Closing local connection \u2014 your phone stays paired."',
+    '  echo "\u2713 Session running via PM2 on the codespace. Closing local connection \u2014 your phone stays paired."',
+    '  echo "  To stop later: gh codespace ssh -- pm2 delete codeam-pair"',
     "  exit 0",
     "else",
-    '  echo "\u2717 Pairing did not complete (codeam pair exited)."',
+    '  echo "\u2717 Pairing did not complete (codeam pair did not start)."',
+    "  pm2 delete codeam-pair >/dev/null 2>&1",
     "  exit 1",
     "fi"
-  ];
-  const wrapper = wrapperLines.join("\n");
+  ].join("\n");
   const code = (await provider.streamCommand(workspace.id, `bash -lc ${shellQuoteSingle(wrapper)}`)).code;
   if (code === 0) {
     gt(import_picocolors8.default.green("\u2713 Workspace deployed and paired. Drive from your phone, anywhere."));
   } else if (code === 130) {
     gt(import_picocolors8.default.yellow("Disconnected from local terminal. Mobile session keeps running on the codespace."));
   } else {
-    gt(import_picocolors8.default.yellow(`Pairing did not complete. Run "codeam pair" inside the codespace if needed.`));
+    gt(import_picocolors8.default.yellow('Pairing did not complete. Run "codeam pair" inside the codespace if needed.'));
   }
 }
 function shellQuoteSingle(s) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.4.12",
+  "version": "2.4.14",
   "description": "Remote control Claude Code (and other AI coding agents) from your mobile phone. Pair your device, send prompts, stream responses in real-time, and approve commands — from anywhere.",
   "main": "dist/index.js",
   "bin": {