handmux 0.22.1 → 0.23.0

package/README.md

@@ -68,7 +68,7 @@ handmux start --tunnel cloudflare   # instant public URL (cloudflared auto-insta
 ## Features
 
 - **Claude Code / Codex, deeply** — an inbox status ledger, thumb-approve permissions & plans, and stable host-wide usage bars shared by every connected device.
-- **Chat view (experimental)** — turn a Claude session into a mobile conversation with Markdown bubbles, colored tool diffs, and tap-to-answer cards; enable it in Settings and switch back to the terminal at any time.
+- **Chat view** — drive Codex CLI through App Server with streaming Markdown bubbles, tool cards, persistent task goals and live status; long replies hold at their beginning for reading, with an explicit jump back to the latest output. Existing panes can switch in place, and messages sent during a turn form an editable server queue. Claude Code chat is an independently enabled experimental option.
 - **Real-time terminal + desktop keyboard** — stream the same tmux pane on phone and desktop with scrollback, weak-network fallback, direct physical-keyboard input, and native copy/paste.
 - **Command & chat modes** — switch between direct terminal input and natural-language agent chat, with a customizable quick bar that stays in sync across devices.
 - **Client reload after updates** — once the server update has finished, use Settings → Reload app to load the new client without quitting and reopening the home-screen app.

package/README.zh-CN.md

@@ -68,7 +68,7 @@ handmux start --tunnel cloudflare   # 即时公网地址(自动装 cloudflared)
 ## 功能一览
 
 - **Claude Code / Codex 深度**——收件箱状态台账、拇指批授权批计划，以及所有设备共享的本机最新 agent 用量。
-- **对话视图（实验性）**——用 Markdown 气泡、彩色工具 diff 和点按回答卡片把 Claude 会话变成移动端对话，可在设置中开启并随时切回终端。
+- **对话视图**——通过 App Server 用流式 Markdown 气泡、工具卡、持久任务目标和实时状态操作 Codex CLI；长回答会稳定在开头供阅读，用户可随时回到最新内容；支持现有 pane 原位接入和回复期间可编辑的服务端消息队列。Claude Code 对话是独立开启的实验性功能。
 - **实时终端 + 电脑键盘**——在手机和电脑上实时操控同一个 tmux pane，支持历史滚动、弱网回退、物理键盘直输和原生复制粘贴。
 - **命令 / 聊天双模式**——在终端直输与自然语言对话间切换，并用跨设备同步的快捷栏快速操作。
 - **更新后重新加载客户端**——服务端更新完成后，在设置里点「重新加载应用」即可载入新版客户端，无需退出主屏应用再重新打开。

package/bin/handmux.js

@@ -34,7 +34,7 @@ import { scanSupervisorPids, terminateSupervisorPids } from '../src/cli/supervis
 import { runSetup } from '../src/cli/setupWizard.js';
 import { commitShortcuts, reportShortcutCommit, runShortcutEditor } from '../src/cli/shortcutEditor.js';
 import { hooksStatus, installHooks, uninstallHooks } from '../src/cli/claudeHooks.js';
-import { codexHooksStatus, installCodexHooks, uninstallCodexHooks } from '../src/cli/codexHooks.js';
+import { removeLegacyCodexHooks } from '../src/cli/legacyCodexHooks.js';
 import { statusLineStatus, installStatusLine, uninstallStatusLine, composeHint, refreshStatusLineScript } from '../src/cli/statusLine.js';
 import { claudeUsagePath } from '../src/usage.js';
 import { probe } from '../src/cli/probe.js';
@@ -42,6 +42,7 @@ import { notifyUpdate, runUpdateCheck, isBrewInstall, PKG_NAME } from '../src/cl
 import { t, initLocale, setLocale } from '../src/cli/i18n/index.js';
 import { runPush } from '../src/cli/pushCmd.js';
 import { runWorkspaceCommand } from '../src/cli/workspaceCmd.js';
+import { runManagedCodex } from '../src/cli/codexManaged.js';
 
 const HOME = homedir();
 const SELF = fileURLToPath(import.meta.url);
@@ -146,6 +147,7 @@ async function main() {
     case 'status': await status(); process.exit(process.exitCode || 0);
     case 'logs': return logs();
     case 'push': process.exitCode = await pushCmd(); return;
+    case 'codex': return codexCmd();
     case 'restore': process.exitCode = await runWorkspaceCommand({ flags, positionals, unknownShortFlags, home: HOME }); return;
     case 'config': return configCmd();
     case 'setup': return setupCmd();
@@ -180,6 +182,15 @@ function version() {
   console.log(currentVersion());
 }
 
+async function codexCmd() {
+  removeLegacyCodexHooks(HOME);
+  try { process.exitCode = await runManagedCodex(process.argv.slice(3), { home: HOME }); }
+  catch (error) {
+    console.error(`[handmux] ${error?.message || error}`);
+    process.exitCode = 1;
+  }
+}
+
 function currentVersion() { return requireOpt('../package.json').version; }
 
 // `handmux update` (alias `upgrade`) — run the plain global install for the user. We don't self-patch or
@@ -471,6 +482,7 @@ function supervisorArgs(cfg) {
 }
 
 async function setupCmd() {
+  removeLegacyCodexHooks(HOME);
   const target = flags.config ? path.resolve(flags.config) : configPath(HOME);
   // Is an instance already up? Then the run-action reads "Save & restart" and applying means a real restart
   // (a running supervisor won't pick up the new config on its own). Captured before the interactive setup so
@@ -480,11 +492,10 @@ async function setupCmd() {
   const res = await runSetup({ home: HOME, target, running });
   if (!res) { process.exit(2); }
   const { cfg, start: doStart } = res;   // hub's "save & start/restart" carries the intent — no separate confirm
-  // Offer to enable the inbox hooks when an agent is present but not yet wired (Claude 'absent', or Codex
-  // 'absent'). installAgentHooks() then wires every present agent (idempotent for any already installed).
-  const offerHooks = hooksStatus(HOME) === 'absent' || codexHooksStatus(HOME) === 'absent';
+  // Codex uses App Server and needs no hooks. Offer this only when Claude Code is present but not wired.
+  const offerHooks = hooksStatus(HOME) === 'absent';
   if (offerHooks && await confirm(t('hooks.confirmEnable'))) {
-    installAgentHooks();
+    installClaudeHooks();
   }
   await maybeOfferStatusLine();
   if (doStart) {
@@ -543,41 +554,31 @@ async function maybeOfferStatusLine() {
   }
 }
 
-// Install the inbox hooks for every coding agent present on this host (Claude Code, Codex — the state file
-// is shared, entries are agent-tagged). Each is opt-in by the mere presence of its config dir. Prints a
-// per-agent line and returns how many were wired, so callers can gate the "reload" hint. Codex's single
-// `notify` slot may already hold the user's OWN program — we never clobber it, we warn.
-function installAgentHooks() {
-  let installed = 0;
-  if (hooksStatus(HOME) !== 'no-claude') {
-    installHooks(HOME, { srcDir: HOOKS_SRC, stateFile: claudeStatePath(HOME) });
-    console.log(t('hooks.installedClaude'));
-    installed++;
-  }
-  if (codexHooksStatus(HOME) !== 'no-codex') {
-    installCodexHooks(HOME, { srcDir: HOOKS_SRC, stateFile: claudeStatePath(HOME) });
-    console.log(t('hooks.installedCodex'));
-    installed++;
-  }
-  return installed;
+// Install Claude Code lifecycle hooks for inbox state and push. Codex never enters this path.
+function installClaudeHooks() {
+  if (hooksStatus(HOME) === 'no-claude') return false;
+  installHooks(HOME, { srcDir: HOOKS_SRC, stateFile: claudeStatePath(HOME) });
+  console.log(t('hooks.installedClaude'));
+  return true;
 }
 
-// `handmux hooks install|uninstall` — opt-in wiring of the coding-agent lifecycle hooks that drive the
-// inbox/push. Never creates ~/.claude or ~/.codex; if neither agent is present we say so and exit 0.
+// `handmux hooks install|uninstall` controls Claude Code lifecycle hooks. Codex is App Server-only;
+// uninstall also removes the exact Handmux Codex hook block left by older releases.
 async function hooksCmd() {
   const sub = process.argv[3];
   if (sub === 'install') {
-    if (hooksStatus(HOME) === 'no-claude' && codexHooksStatus(HOME) === 'no-codex') {
-      console.log(t('hooks.noAgents'));
+    removeLegacyCodexHooks(HOME);
+    if (hooksStatus(HOME) === 'no-claude') {
+      console.log(t('hooks.noClaude'));
       return;
     }
-    if (installAgentHooks() > 0) console.log(t('hooks.installedHint'));
+    if (installClaudeHooks()) console.log(t('hooks.installedHint'));
     await maybeOfferStatusLine();
     return;
   }
   if (sub === 'uninstall') {
     uninstallHooks(HOME);
-    uninstallCodexHooks(HOME);
+    removeLegacyCodexHooks(HOME);
     uninstallStatusLine(HOME);
     console.log(t('hooks.removed'));
     return;

package/hooks/handmux-notify.sh

@@ -1,9 +1,7 @@
 #!/bin/sh
 # handmux 上报 hook. $1 = stop | notify | prompt | end | resume | permreq | compacting | compact | stopfail.
 # (compacting/compact/stopfail 是版本门控事件:PreCompact/PostCompact/StopFailure，只在够新的 Claude 上注册。)
-# $2 = agent id(留空=claude;
-# Codex 传 'codex')—— Claude 与 Codex 的 hook payload 字段一致(stdin JSON),所以共用这一个脚本。
-# stdin = agent 原始 payload(JSON).
+# stdin = Claude Code 原始 payload(JSON).
 # (resume  = PostToolUse on AskUserQuestion/ExitPlanMode:答完选项/批准计划 → 状态翻回进行中、带所选项。)
 # (permreq = PermissionRequest:真实弹框一出现就发、带 tool_name → 比 permission_prompt 早亮「需要你」。)
 # 只做一件事:把本次事件写进一个本地 JSON 状态文件(键=tmux pane,值=该 pane 最新事件)。不联网、
@@ -20,5 +18,5 @@ TS=$(perl -MTime::HiRes -e 'printf "%.0f", Time::HiRes::time()*1000' 2>/dev/null
 HOST=$(hostname 2>/dev/null || printf '')
 # payload 经 stdin 原样流给 node(不在 shell 里转义,避免坏数据);pane 含 '%' 直接进 JSON 字段,
 # 不再进 URL → 彻底告别旧的 "%110 被 url-decode 丢弃" 那类坑。
-node "$(dirname "$0")/handmux-write.cjs" "$FILE" "$PANE" "$1" "$TS" "$HOST" "$2" 2>/dev/null || true
+node "$(dirname "$0")/handmux-write.cjs" "$FILE" "$PANE" "$1" "$TS" "$HOST" 2>/dev/null || true
 exit 0

package/hooks/handmux-write.cjs

@@ -14,9 +14,8 @@
 // or corrupt the file. Best-effort throughout and silent — the hook is fire-and-forget and must never
 // fail Claude (the shell wrapper swallows errors and always exits 0).
 const fs = require('node:fs');
-const path = require('node:path');
 
-const [, , file, pane, src, ts, host = '', agent = ''] = process.argv;
+const [, , file, pane, src, ts, host = ''] = process.argv;
 if (!file || !pane || !src) process.exit(0);
 
 let payload = {};
@@ -58,20 +57,8 @@ function update() {
     const curSid = obj[pane] && obj[pane].payload && obj[pane].payload.session_id;
     const endSid = payload && payload.session_id;
     if (!curSid || !endSid || curSid === endSid) delete obj[pane];
-  } else if (src === 'resume' && agent === 'codex') {
-    // Codex fires PostToolUse on EVERY tool call, so its resume exists purely to un-stick a pane from 需要你
-    // back to 进行中 after the user approved a PermissionRequest. Apply it ONLY as that transition — a mid-
-    // turn tool call (pane already 进行中 / 已完成) is a no-op, so we don't rewrite the entry on every
-    // command (the load Claude's matcher avoids). Claude's resume — no agent arg — is unaffected.
-    const prev = obj[pane];
-    const prevPerm = prev && (prev.src === 'permreq'
-      || (prev.src === 'notify' && (prev.payload || {}).notification_type === 'permission_prompt'));
-    if (!prevPerm) { return; }
-    obj[pane] = { ts: Number(ts) || 0, src, host, payload, agent };
   } else {
-    // agent tag lets the server dispatch classify + liveness per agent (Codex passes 'codex'); omitted for
-    // Claude so legacy entries stay byte-identical and default to claude server-side.
-    obj[pane] = { ts: Number(ts) || 0, src, host, payload, ...(agent ? { agent } : {}) };
+    obj[pane] = { ts: Number(ts) || 0, src, host, payload };
   }
   const tmp = `${file}.${process.pid}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(obj));
@@ -89,12 +76,3 @@ for (let i = 0; i < 60 && !held; i++) {                       // ~0.9s budget, t
 }
 try { update(); } catch { /* best effort */ }
 if (held) { try { fs.unlinkSync(lock); } catch { /* ignore */ } }
-
-// Codex hook payloads include the exact rollout transcript_path. Capture its latest token_count into a
-// machine-wide snapshot after the inbox update; failures are isolated so usage can never break the hook.
-if (agent === 'codex' && typeof payload.transcript_path === 'string') {
-  try {
-    const { captureTranscript } = require('./handmux-codex-usage.cjs');
-    captureTranscript(payload.transcript_path, path.join(path.dirname(file), 'codex-usage.json'));
-  } catch { /* best effort */ }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "A mobile vibe-coding cockpit — built on tmux: drive your live session, Claude Code / Codex — anything a terminal can run — from your phone.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -62,13 +62,13 @@
     "vitest": "^2.0.0"
   },
   "whatsNew": [
+    {"version":"0.23.0","date":"2026-08-09","zh":"Codex 托管对话正式上线","en":"Managed Codex chat is here"},
     {"version":"0.22.1","date":"2026-08-04","zh":"网页宽度与网站版本分开控制","en":"Separate page width and site-version controls"},
     {"version":"0.22.0","date":"2026-08-03","zh":"全屏设置 · 窗口与分屏管理更清晰","en":"Full-screen Settings · clearer window and pane management"},
     {"version":"0.21.0","date":"2026-08-03","zh":"网页预览：手机直连、电脑代理与静态目录","en":"Web preview: direct, computer proxy, and static folders"},
     {"version":"0.20.3","date":"2026-08-01","zh":"实时终端显示更稳定流畅","en":"More stable, smoother live terminals"},
     {"version":"0.20.2","date":"2026-07-27","zh":"实时终端长时间运行更流畅","en":"Smoother long-running live terminals"},
     {"version":"0.20.1","date":"2026-07-26","zh":"聊天发送修复 · 电脑键盘不中断","en":"Reliable chat sending · uninterrupted desktop input"},
-    {"version":"0.20.0","date":"2026-07-26","zh":"终端实时推送 · 弱网自动回退","en":"Live terminal pushing · automatic network fallback"},
-    {"version":"0.19.0","date":"2026-07-25","zh":"电脑物理键盘直输 · Window 切换更流畅","en":"Desktop keyboard input · faster window switching"}
+    {"version":"0.20.0","date":"2026-07-26","zh":"终端实时推送 · 弱网自动回退","en":"Live terminal pushing · automatic network fallback"}
   ]
 }