codeam-cli 2.12.15 → 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

@@ -5,10 +5,12 @@
 [![license](https://img.shields.io/npm/l/codeam-cli.svg?color=34d399&style=flat-square)](https://github.com/edgar-durand/codeagent-mobile-clients/blob/main/LICENSE)
 [![node](https://img.shields.io/node/v/codeam-cli.svg?color=34d399&style=flat-square)](https://nodejs.org/)
 
-> **Remote control [Claude Code](https://claude.ai/code) from your phone.**
+> **Remote control AI coding agents from your phone.**
 > Send prompts, stream responses, and approve commands in real-time — from the subway, the couch, or anywhere away from your desk.
 
-`codeam-cli` is the companion CLI for [**CodeAgent Mobile**](https://codeagent-mobile.com). It wraps Claude Code inside a pseudo-terminal, relays your mobile prompts to the agent, and streams the output back to your phone in real-time.
+`codeam-cli` is the companion CLI for [**CodeAgent Mobile**](https://codeagent-mobile.com). It wraps AI coding agents inside a pseudo-terminal, relays your mobile prompts to the agent, and streams the output back to your phone in real-time.
+
+Currently supports **[Claude Code](https://claude.ai/code)** (Anthropic) and **[OpenAI Codex](https://github.com/openai/codex)** — start either via `codeam` (Claude Code) or `codeam codex` (OpenAI Codex).
 
 ---
 
@@ -41,14 +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 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 |
 
@@ -94,6 +100,7 @@ Adding more cloud backends (Gitpod, Coder, your own SSH host, …) is a single n
 
 - **Node.js 18+**
 - **Claude Code** — see the [official quickstart](https://code.claude.com/docs/en/quickstart)
+- **OpenAI Codex** (optional) — see the [official quickstart](https://github.com/openai/codex)
 - **[CodeAgent Mobile](https://codeagent-mobile.com)** app on your phone ([iOS](https://apps.apple.com/) / [Android](https://play.google.com/store/apps/details?id=com.codeagent.mobile))
 
 ---
@@ -102,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

@@ -1658,6 +1658,13 @@ function makeConfig(baseDir) {
     }
     return session;
   }
+  function getActiveSessionForAgent2(agent) {
+    const c2 = load();
+    const matches = c2.sessions.filter((s) => s.agent === agent);
+    if (matches.length === 0) return null;
+    matches.sort((a, b) => b.pairedAt - a.pairedAt);
+    return matches[0];
+  }
   function clearAll2() {
     try {
       fs.unlinkSync(file);
@@ -1670,10 +1677,10 @@ function makeConfig(baseDir) {
   function loadCliConfig2() {
     return load();
   }
-  return { getConfig: getConfig2, ensurePluginId: ensurePluginId2, addSession: addSession2, removeSession: removeSession2, setActiveSession: setActiveSession2, getActiveSession: getActiveSession2, clearAll: clearAll2, saveCliConfig: saveCliConfig2, loadCliConfig: loadCliConfig2 };
+  return { getConfig: getConfig2, ensurePluginId: ensurePluginId2, addSession: addSession2, removeSession: removeSession2, setActiveSession: setActiveSession2, getActiveSession: getActiveSession2, getActiveSessionForAgent: getActiveSessionForAgent2, clearAll: clearAll2, saveCliConfig: saveCliConfig2, loadCliConfig: loadCliConfig2 };
 }
 var _default = makeConfig();
-var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, getActiveSession, clearAll, saveCliConfig, loadCliConfig } = _default;
+var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, getActiveSession, getActiveSessionForAgent, clearAll, saveCliConfig, loadCliConfig } = _default;
 
 // src/ui/banner.ts
 var import_picocolors = __toESM(require("picocolors"));
@@ -1682,7 +1689,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.12.15",
+  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",
@@ -4825,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) {
@@ -4841,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.
@@ -5804,7 +5822,7 @@ var BOX_DRAW_RE = /^[╭─╮│╰╯]/u;
 var BULLET_CHARS = "\u2022\xB7\u2027\u2219\u22C5";
 var CODEX_AGENT_REPLY_RE = new RegExp(`^[${BULLET_CHARS}]\\s`, "u");
 var STRIP_BULLET_RE = new RegExp(`^(\\s*)[${BULLET_CHARS}]\\s`, "u");
-var CODEX_USER_ECHO_RE = /^[›>]\s+\S/u;
+var CODEX_USER_ECHO_RE = /^[›>]\s+(?!\d+\.\s)\S/u;
 var TIP_RE = /^\s*Tip:\s/i;
 var LEARN_MORE_RE = /^\s*Learn more:\s/i;
 var CODEX_STATUS_FOOTER_RE = /\bdefault\s+[·•]\s+\S+/i;
@@ -5979,8 +5997,53 @@ function wrapCodexCodeBlocks(lines) {
 function parseCodexChrome(_line) {
   return null;
 }
-function detectCodexSelector(_lines) {
-  return null;
+function detectCodexSelector(lines) {
+  const hasConfirmTrailer = lines.some(
+    (l) => /press\s+enter\s+to\s+confirm/i.test(l)
+  );
+  if (!hasConfirmTrailer) return null;
+  let optionStartIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^\s*(?:>\s+)?\d+\.\s/.test(lines[i])) {
+      optionStartIdx = i;
+      break;
+    }
+  }
+  if (optionStartIdx === -1) return null;
+  const questionParts = [];
+  for (let i = 0; i < optionStartIdx; i++) {
+    const t2 = lines[i].trim();
+    if (!t2) continue;
+    if (/^[>›]\s*$/.test(t2)) continue;
+    questionParts.push(t2);
+  }
+  const question = questionParts.join("\n").trim();
+  const optionLabels = /* @__PURE__ */ new Map();
+  let cursorIndex = 0;
+  let hasCursor = false;
+  for (let i = optionStartIdx; i < lines.length; i++) {
+    const t2 = lines[i].trim();
+    if (!t2) continue;
+    if (/^press\s+enter\s+to\s+confirm/i.test(t2)) break;
+    const m = t2.match(/^(>\s+)?(\d+)\.\s+(.+)/);
+    if (!m) continue;
+    const num = parseInt(m[2], 10);
+    if (!optionLabels.has(num)) {
+      optionLabels.set(num, m[3].trim());
+      if (m[1]) {
+        cursorIndex = optionLabels.size - 1;
+        hasCursor = true;
+      }
+    }
+  }
+  const keys = [...optionLabels.keys()].sort((a, b) => a - b);
+  if (keys.length < 2 || keys[0] !== 1) return null;
+  return {
+    question,
+    options: keys.map((k2) => optionLabels.get(k2)),
+    optionDescriptions: keys.map(() => ""),
+    currentIndex: hasCursor ? cursorIndex : 0
+  };
 }
 
 // src/agents/codex/renderer.ts
@@ -8103,13 +8166,22 @@ async function dispatchCommand(ctx, cmd) {
 }
 
 // src/commands/start.ts
-async function start() {
+async function start(requestedAgent) {
   showIntro();
-  const session = getActiveSession();
+  const session = requestedAgent ? getActiveSessionForAgent(requestedAgent) : getActiveSession();
   if (!session) {
-    console.log(`  ${import_picocolors2.default.dim("No paired session found.")}`);
-    console.log(`  ${import_picocolors2.default.dim(`Run ${import_picocolors2.default.white("codeam pair")} to connect your mobile app.`)}
+    if (requestedAgent) {
+      const displayName = AGENT_REGISTRY[requestedAgent]?.displayName ?? requestedAgent;
+      console.log(`  ${import_picocolors2.default.dim(`No paired ${displayName} session found.`)}`);
+      console.log(
+        `  ${import_picocolors2.default.dim(`Run ${import_picocolors2.default.white("codeam pair")} from a ${displayName} setup to connect your mobile app.`)}
+`
+      );
+    } else {
+      console.log(`  ${import_picocolors2.default.dim("No paired session found.")}`);
+      console.log(`  ${import_picocolors2.default.dim(`Run ${import_picocolors2.default.white("codeam pair")} to connect your mobile app.`)}
 `);
+    }
     process.exit(0);
   }
   if (!session.agent) {
@@ -10443,7 +10515,7 @@ async function stopWorkspaceFromLocal(target) {
 // src/commands/version.ts
 var import_picocolors11 = __toESM(require("picocolors"));
 function version() {
-  const v = true ? "2.12.15" : "unknown";
+  const v = true ? "2.12.17" : "unknown";
   console.log(`${import_picocolors11.default.bold("codeam-cli")} ${import_picocolors11.default.cyan(v)}`);
 }
 
@@ -10452,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")}`,
@@ -10578,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.15" : null;
+  const current = true ? "2.12.17" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -10621,6 +10697,9 @@ async function main() {
       if (args[0] === "stop" || args[0] === "remove") return deployStop();
       return deploy(args);
     default:
+      if (typeof command === "string" && isKnownAgentId(command)) {
+        return start(command);
+      }
       return start();
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.12.15",
+  "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",