codeam-cli 2.12.16 → 2.12.17

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.12.16] — 2026-05-15
+
+### Documentation
+
+- **meta:** Mention Codex support across CLI/VS Code/JetBrains/README
+
+### Fixed
+
+- **cli:** Scope codeam <agent> restore to that agent's most-recent session
+- **cli:** Detect Codex shell-approval prompts as a select_prompt
+
 ## [2.12.14] — 2026-05-14
 
 ### Fixed

package/README.md

@@ -43,15 +43,18 @@ That's it. Open the [CodeAgent Mobile app](https://codeagent-mobile.com), enter
 
 | Command | What it does |
 |---|---|
-| `codeam` | Start Claude Code in the current directory, with mobile control |
-| `codeam codex` | Start OpenAI Codex in the current directory, with mobile control |
-| `codeam pair` | Pair a new mobile device (6-digit code or QR) |
+| `codeam` | Start the active agent in the current directory, with mobile control |
+| `codeam <agent>` | Start a specific agent — `codeam claude`, `codeam codex`, … |
+| `codeam pair` | Pair a new mobile device (6-character code or QR, interactive agent picker) |
+| `codeam pair --agent <id>` | Pair non-interactively for a specific agent (`claude`, `codex`, …) — useful in scripts |
 | `codeam sessions` | List all paired devices |
+| `codeam sessions switch` | Choose which paired session the next `codeam` invocation will use |
+| `codeam sessions delete <session-id>` | Forget a specific paired session (leaves the others intact) |
 | `codeam status` | Show connection status |
 | `codeam logout` | Remove all paired sessions |
 | `codeam deploy` | Provision a cloud workspace (GitHub Codespaces) and pair it to your phone |
-| `codeam deploy ls` | List the cloud workspaces you've deployed (and which still have a session running) |
-| `codeam deploy stop` | Pick a deployed workspace and stop its codeam session (and optionally the workspace itself) |
+| `codeam deploy ls` (alias `list`) | List the cloud workspaces you've deployed (and which still have a session running) |
+| `codeam deploy stop` (alias `remove`) | Pick a deployed workspace and stop its codeam session (and optionally the workspace itself) |
 | `codeam --version`, `-v` | Print the installed CLI version |
 | `codeam --help`, `-h` | Show usage and the full command list |
 
@@ -106,7 +109,25 @@ Adding more cloud backends (Gitpod, Coder, your own SSH host, …) is a single n
 
 | Variable | Default | Effect |
 |---|---|---|
-| `CODEAM_DISABLE_UPDATE_CHECK` | unset | Set to `1` to suppress the "update available" banner. The check also auto-skips on non-TTY stdout, in CI, and during tests. |
+| `CODEAM_API_URL` | `https://codeagent-mobile-api.vercel.app` | Override the backend relay URL. Useful for hitting a staging environment or self-hosted backend. |
+| `CODEAM_DISABLE_UPDATE_CHECK` | unset | Set to `1` to suppress the "update available" banner. The check also auto-skips on non-TTY stdout, when `CI=true`, and during tests. |
+| `CODEAM_AUTO_TOKEN` | unset | One-shot pairing token consumed by `codeam pair-auto`. Used by the `codeam deploy` bootstrap; see *Advanced / scripted pairing* below. |
+
+---
+
+## Advanced / scripted pairing
+
+For automation (CI, Codespaces bootstraps, container entry-points) `codeam` ships a non-interactive pairing command:
+
+```bash
+codeam pair-auto --token=<one-shot-pairing-token>
+# or
+codeam pair-auto --token-file=/path/to/token
+# or pass the token via env:
+CODEAM_AUTO_TOKEN=<token> codeam pair-auto
+```
+
+This is the same path `codeam deploy` uses inside a freshly-provisioned Codespace to pair the cloud session to your phone with zero interactive prompts. End users on a laptop should keep using the interactive `codeam pair`.
 
 ---
 

package/dist/index.js

@@ -1689,7 +1689,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.12.16",
+  version: "2.12.17",
   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.",
   type: "commonjs",
   main: "dist/index.js",
@@ -4832,8 +4832,17 @@ var AgentService = class {
    * the pre-batch (empty/previous) state → Enter submits nothing and the text
    * stays visible-but-unsubmitted in the input field.
    *
-   * Sending '\r' in a separate write() 50 ms later guarantees it arrives on
+   * Sending '\r' in a separate write() ~50 ms later guarantees it arrives on
    * a fresh event-loop tick, after React has flushed the text into input state.
+   *
+   * The delay scales with line count: Smart Composer outputs are ~500–1500
+   * chars with embedded `\n`s (Task / Context / Steps blocks). Ink's input
+   * field re-flows multi-line content per render and the 50 ms baseline that
+   * worked for single-line prompts isn't enough headroom — the text lands in
+   * the field but `\r` submits stale state and the prompt sits there until
+   * the user hits Enter manually. Adding ~40 ms per extra line (capped at
+   * 300 ms) keeps short prompts snappy while giving multi-line composer
+   * outputs the time they need to settle.
    */
   sendCommand(text) {
     if (!this.strategy) {
@@ -4848,7 +4857,9 @@ var AgentService = class {
     const s = this.strategy;
     log.trace("claude", `sendCommand text=${text.length}B`);
     s.write(text);
-    setTimeout(() => s.write("\r"), 50);
+    const lineCount = text.split("\n").length;
+    const delay = Math.min(300, 50 + (lineCount - 1) * 40);
+    setTimeout(() => s.write("\r"), delay);
   }
   /**
    * Navigate a React Ink selector to the given 0-based target index and confirm.
@@ -10504,7 +10515,7 @@ async function stopWorkspaceFromLocal(target) {
 // src/commands/version.ts
 var import_picocolors11 = __toESM(require("picocolors"));
 function version() {
-  const v = true ? "2.12.16" : "unknown";
+  const v = true ? "2.12.17" : "unknown";
   console.log(`${import_picocolors11.default.bold("codeam-cli")} ${import_picocolors11.default.cyan(v)}`);
 }
 
@@ -10513,24 +10524,28 @@ var import_picocolors12 = __toESM(require("picocolors"));
 function help() {
   const lines = [
     "",
-    `  ${import_picocolors12.default.bold(import_picocolors12.default.magenta("codeam-cli"))}  ${import_picocolors12.default.dim("\u2014 Claude Code remote control")}`,
+    `  ${import_picocolors12.default.bold(import_picocolors12.default.magenta("codeam-cli"))}  ${import_picocolors12.default.dim("\u2014 remote-control AI coding agents from your phone")}`,
     "",
     `  ${import_picocolors12.default.bold("Usage")}`,
     `     ${import_picocolors12.default.cyan("codeam")} ${import_picocolors12.default.dim("[command]")}`,
     "",
     `  ${import_picocolors12.default.bold("Commands")}`,
-    `     ${import_picocolors12.default.white("codeam")}              ${import_picocolors12.default.dim("start Claude Code with mobile control")}`,
-    `     ${import_picocolors12.default.white("codeam pair")}         ${import_picocolors12.default.dim("pair a new mobile device")}`,
-    `     ${import_picocolors12.default.white("codeam sessions")}     ${import_picocolors12.default.dim("list paired devices")}`,
-    `     ${import_picocolors12.default.white("codeam status")}       ${import_picocolors12.default.dim("show connection info")}`,
-    `     ${import_picocolors12.default.white("codeam logout")}       ${import_picocolors12.default.dim("remove all paired sessions")}`,
-    `     ${import_picocolors12.default.white("codeam deploy")}       ${import_picocolors12.default.dim("provision a cloud workspace (Codespaces) and pair it")}`,
-    `     ${import_picocolors12.default.white("codeam deploy ls")}    ${import_picocolors12.default.dim("list deployed cloud workspaces")}`,
-    `     ${import_picocolors12.default.white("codeam deploy stop")}  ${import_picocolors12.default.dim("stop a deployed workspace session")}`,
+    `     ${import_picocolors12.default.white("codeam")}                       ${import_picocolors12.default.dim("start the active agent with mobile control")}`,
+    `     ${import_picocolors12.default.white("codeam <agent>")}               ${import_picocolors12.default.dim("start a specific agent \u2014 e.g. claude, codex")}`,
+    `     ${import_picocolors12.default.white("codeam pair")}                  ${import_picocolors12.default.dim("pair a new mobile device (interactive)")}`,
+    `     ${import_picocolors12.default.white("codeam pair --agent <id>")}     ${import_picocolors12.default.dim("pair non-interactively for a specific agent")}`,
+    `     ${import_picocolors12.default.white("codeam sessions")}              ${import_picocolors12.default.dim("list paired devices")}`,
+    `     ${import_picocolors12.default.white("codeam sessions switch")}       ${import_picocolors12.default.dim("switch the active paired session")}`,
+    `     ${import_picocolors12.default.white("codeam sessions delete <id>")}  ${import_picocolors12.default.dim("remove a specific paired session")}`,
+    `     ${import_picocolors12.default.white("codeam status")}                ${import_picocolors12.default.dim("show connection info")}`,
+    `     ${import_picocolors12.default.white("codeam logout")}                ${import_picocolors12.default.dim("remove all paired sessions")}`,
+    `     ${import_picocolors12.default.white("codeam deploy")}                ${import_picocolors12.default.dim("provision a cloud workspace (Codespaces) and pair it")}`,
+    `     ${import_picocolors12.default.white("codeam deploy ls | list")}      ${import_picocolors12.default.dim("list deployed cloud workspaces")}`,
+    `     ${import_picocolors12.default.white("codeam deploy stop | remove")}  ${import_picocolors12.default.dim("stop a deployed workspace session")}`,
     "",
     `  ${import_picocolors12.default.bold("Flags")}`,
-    `     ${import_picocolors12.default.white("-v, --version")}       ${import_picocolors12.default.dim("print the CLI version")}`,
-    `     ${import_picocolors12.default.white("-h, --help")}          ${import_picocolors12.default.dim("show this help")}`,
+    `     ${import_picocolors12.default.white("-v, --version")}                ${import_picocolors12.default.dim("print the CLI version")}`,
+    `     ${import_picocolors12.default.white("-h, --help")}                   ${import_picocolors12.default.dim("show this help")}`,
     "",
     `  ${import_picocolors12.default.bold("Links")}`,
     `     ${import_picocolors12.default.dim("Docs:")}     ${import_picocolors12.default.green("https://www.codeagent-mobile.com")}`,
@@ -10639,7 +10654,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.12.16" : null;
+  const current = true ? "2.12.17" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.12.16",
+  "version": "2.12.17",
   "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.",
   "type": "commonjs",
   "main": "dist/index.js",