codeam-cli 1.4.55 → 1.4.57

package/README.md

@@ -1,25 +1,81 @@
 # codeam-cli
 
-Remote control [Claude Code](https://claude.ai/code) from your mobile device using [CodeAgent Mobile](https://www.codeagent-mobile.com).
+[![npm version](https://img.shields.io/npm/v/codeam-cli.svg?color=34d399&style=flat-square)](https://www.npmjs.com/package/codeam-cli)
+[![npm downloads](https://img.shields.io/npm/dm/codeam-cli.svg?color=34d399&style=flat-square)](https://www.npmjs.com/package/codeam-cli)
+[![license](https://img.shields.io/npm/l/codeam-cli.svg?color=34d399&style=flat-square)](https://github.com/edgardurand/codeagent-mobile/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/codeam-cli.svg?color=34d399&style=flat-square)](https://nodejs.org/)
 
-## Install
+> **Remote control [Claude Code](https://claude.ai/code) 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.
+
+---
+
+## Why does this exist?
+
+Because sometimes your best ideas happen away from the keyboard. Maybe you're on a walk, on the train, in a meeting, or just want to keep a long-running task going while you step away. `codeam-cli` lets your AI agent keep working — and lets **you** keep shipping — without needing to be at your machine.
+
+It works exactly like Claude Code (same terminal, same project, same files), but every prompt and every response is mirrored on your phone. You can even approve interactive selectors and confirmations from mobile.
+
+---
+
+## Quick Start
 
 ```bash
+# 1. Install once
 npm install -g codeam-cli
-```
 
-## Usage
+# 2. Pair your phone (generates a 6-character code)
+codeam pair
 
-```bash
-codeam pair        # Pair with your mobile device
-codeam             # Start Claude Code with mobile control
-codeam sessions    # List paired sessions
-codeam status      # Show connection status
-codeam logout      # Remove all sessions
+# 3. Run Claude Code with mobile control (every time after that)
+codeam
 ```
 
+That's it. Open the [CodeAgent Mobile app](https://codeagent-mobile.com), enter the code, and you're controlling Claude Code from your phone.
+
+---
+
+## Commands
+
+| 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 sessions` | List all paired devices |
+| `codeam status` | Show connection status |
+| `codeam logout` | Remove all paired sessions |
+
+---
+
 ## Requirements
 
-- Node.js 18+
-- Claude Code installed — see the [official quickstart](https://code.claude.com/docs/en/quickstart)
-- [CodeAgent Mobile](https://www.codeagent-mobile.com) app on your phone
+- **Node.js 18+**
+- **Claude Code** — see the [official quickstart](https://code.claude.com/docs/en/quickstart)
+- **[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))
+
+---
+
+## How it works
+
+1. `codeam-cli` spawns Claude Code inside a Python PTY helper so Claude sees a real TTY.
+2. Raw PTY output runs through a virtual terminal renderer, interactive selectors are detected, and TUI chrome is filtered out.
+3. Clean output chunks are pushed to CodeAgent's backend relay.
+4. Your phone connects to the same relay via WebSocket. Every prompt you type on mobile is sent back to the PTY as if typed on your keyboard.
+5. Everything happens on **your machine** — your code never leaves it. The relay only forwards prompts and sanitized output.
+
+---
+
+## Related
+
+- **[CodeAgent Mobile app](https://codeagent-mobile.com)** — the phone app this CLI talks to
+- **[VS Code / Cursor / Windsurf extension](https://marketplace.visualstudio.com/items?itemName=CodeAgentMobile.codeagent-mobile)** — use inside your editor instead of the terminal
+- **[JetBrains plugin](https://plugins.jetbrains.com/plugin/30697-codeagent-mobile)** — IntelliJ, WebStorm, PyCharm, Rider, etc.
+- **[FAQ & Docs](https://codeagent-mobile.com/faq)**
+
+---
+
+## License
+
+MIT © [Edgar Durand](https://github.com/edgardurand)

package/dist/index.js

@@ -116,8 +116,8 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "1.4.55",
-  description: "Remote control Claude Code from your mobile device",
+  version: "1.4.57",
+  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: {
     codeam: "dist/index.js"
@@ -137,12 +137,34 @@ var package_default = {
   keywords: [
     "claude",
     "claude-code",
+    "claude-code-mobile",
     "ai",
+    "ai-agent",
+    "ai-coding",
+    "ai-pair-programming",
     "cli",
     "remote-control",
+    "remote-development",
+    "mobile-ide",
+    "mobile-coding",
+    "pair-programming",
     "codeagent",
-    "codeam"
+    "codeam",
+    "anthropic",
+    "cursor",
+    "copilot",
+    "jetbrains",
+    "vscode",
+    "mcp",
+    "code-from-phone",
+    "afk-coding",
+    "remote-pair-programming",
+    "agent-control"
   ],
+  homepage: "https://codeagent-mobile.com",
+  bugs: {
+    url: "https://github.com/edgardurand/codeagent-mobile/issues"
+  },
   author: "Edgar Durand",
   repository: {
     type: "git",
@@ -2130,6 +2152,16 @@ except Exception:sys.exit(0)
         }
         break;
       }
+      case "list_models": {
+        const models = [
+          { id: "claude-opus-4-7", label: "Claude Opus 4.7", description: "Most capable", family: "claude", vendor: "anthropic", isDefault: false },
+          { id: "claude-opus-4-6", label: "Claude Opus 4.6", description: "Top tier", family: "claude", vendor: "anthropic", isDefault: false },
+          { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", description: "Balanced", family: "claude", vendor: "anthropic", isDefault: true },
+          { id: "claude-haiku-4-5-20251001", label: "Claude Haiku 4.5", description: "Fastest", family: "claude", vendor: "anthropic", isDefault: false }
+        ];
+        await relay.sendResult(cmd.id, "completed", { models });
+        break;
+      }
     }
   });
   ws.addHandler({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codeam-cli",
-  "version": "1.4.55",
-  "description": "Remote control Claude Code from your mobile device",
+  "version": "1.4.57",
+  "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": {
     "codeam": "dist/index.js"
@@ -21,12 +21,34 @@
   "keywords": [
     "claude",
     "claude-code",
+    "claude-code-mobile",
     "ai",
+    "ai-agent",
+    "ai-coding",
+    "ai-pair-programming",
     "cli",
     "remote-control",
+    "remote-development",
+    "mobile-ide",
+    "mobile-coding",
+    "pair-programming",
     "codeagent",
-    "codeam"
+    "codeam",
+    "anthropic",
+    "cursor",
+    "copilot",
+    "jetbrains",
+    "vscode",
+    "mcp",
+    "code-from-phone",
+    "afk-coding",
+    "remote-pair-programming",
+    "agent-control"
   ],
+  "homepage": "https://codeagent-mobile.com",
+  "bugs": {
+    "url": "https://github.com/edgardurand/codeagent-mobile/issues"
+  },
   "author": "Edgar Durand",
   "repository": {
     "type": "git",