handmux 0.5.3 → 0.7.0

package/hooks/handmux-statusline.cjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+// handmux statusLine capturer. Claude Code pipes a JSON blob to its `statusLine` command on stdin — the
+// ONLY officially-documented local source of the 5-hour / weekly rate-limit percentages (the same numbers
+// `/usage` shows). See https://code.claude.com/docs/en/statusline ("Available data": rate_limits.five_hour
+// / seven_day, context_window, model). We snapshot those fields to a file the handmux server serves to the
+// phone's Usage page, then produce stdout so the terminal statusline still works:
+//
+//   node handmux-statusline.cjs <usageFile>                        # snapshot + print a compact status line
+//   HANDMUX_STATUS_TEE=1 node handmux-statusline.cjs <usageFile>   # snapshot + re-emit stdin verbatim
+//
+// TEE mode is for a user who ALREADY has a statusline: they pipe `... | handmux-statusline.cjs <f> | their
+// renderer`, so their renderer downstream receives the exact same JSON and their display is unchanged.
+//
+// .cjs so it runs standalone via `node <file>` regardless of any surrounding package.json "type". Best-
+// effort and silent throughout — a statusLine command must never fail Claude.
+const fs = require('node:fs');
+const path = require('node:path');
+
+const file = process.argv[2];
+const raw = (() => { try { return fs.readFileSync(0, 'utf8'); } catch { return ''; } })();
+let j = {};
+try { j = JSON.parse(raw || '{}'); } catch { /* not JSON → leave j = {} */ }
+
+// One rate-limit window → our shape, or undefined if the field is absent (rate_limits only appears for
+// Pro/Max plans, and only after a session's first API response).
+function win(o) {
+  if (!o || typeof o.used_percentage !== 'number') return undefined;
+  const w = { usedPercent: o.used_percentage };
+  if (typeof o.resets_at === 'number') w.resetsAt = o.resets_at;
+  return w;
+}
+
+if (file) {
+  try {
+    const rl = j.rate_limits || {};
+    const cw = j.context_window || {};
+    const rateLimits = {
+      fiveHour: win(rl.five_hour),
+      sevenDay: win(rl.seven_day),
+      sevenDayOpus: win(rl.seven_day_opus),
+      sevenDaySonnet: win(rl.seven_day_sonnet),
+    };
+    for (const k of Object.keys(rateLimits)) if (rateLimits[k] === undefined) delete rateLimits[k];
+    const snap = {
+      updatedAt: Date.now(),
+      model: (j.model && (j.model.display_name || j.model.id)) || null,
+      context: (typeof cw.used_percentage === 'number') ? { usedPercent: cw.used_percentage } : undefined,
+      rateLimits,
+    };
+    if (snap.context === undefined) delete snap.context;
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(snap));
+    fs.renameSync(tmp, file); // atomic: concurrent statuslines (multiple sessions) can't tear the snapshot
+  } catch { /* best effort — never fail the statusline */ }
+}
+
+// Output. TEE → re-emit stdin so a downstream renderer is unaffected. Otherwise render a compact line from
+// whatever fields are present (a plain default statusline for users who had none).
+if (process.env.HANDMUX_STATUS_TEE === '1') {
+  process.stdout.write(raw);
+} else {
+  try {
+    const seg = [];
+    const dir = j.workspace && j.workspace.current_dir;
+    if (dir) seg.push(path.basename(dir));
+    if (j.model && j.model.display_name) seg.push(j.model.display_name);
+    const cw = j.context_window || {};
+    if (typeof cw.used_percentage === 'number') seg.push(`Ctx ${Math.round(cw.used_percentage)}%`);
+    const rl = j.rate_limits || {};
+    if (rl.five_hour && typeof rl.five_hour.used_percentage === 'number') seg.push(`5h ${Math.round(rl.five_hour.used_percentage)}%`);
+    if (rl.seven_day && typeof rl.seven_day.used_percentage === 'number') seg.push(`Wk ${Math.round(rl.seven_day.used_percentage)}%`);
+    if (seg.length) process.stdout.write(seg.join(' · '));
+  } catch { /* silent */ }
+}

package/hooks/handmux-write.cjs

@@ -16,7 +16,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
-const [, , file, pane, src, ts, host = ''] = process.argv;
+const [, , file, pane, src, ts, host = '', agent = ''] = process.argv;
 if (!file || !pane || !src) process.exit(0);
 
 let payload = {};
@@ -27,7 +27,6 @@ try { payload = JSON.parse(fs.readFileSync(0, 'utf8') || '{}'); } catch { /* unr
 // terminates an ESC-interrupted working turn (→ clear the stuck 进行中). Flag it here; the read-modify-
 // write under the lock — the only place we can read the prior state safely — makes the call.
 const isIdle = src === 'notify' && payload && payload.notification_type === 'idle_prompt';
-let cleared = false; // set by update() when idle cleared an interrupted 进行中 → also clear @claude_dot below
 
 // Synchronous nap without busy-spinning (the hook runs async, so a few ms is free). SharedArrayBuffer
 // may be unavailable in odd runtimes — fall back to a tiny busy loop so the lock retry still paces.
@@ -47,14 +46,26 @@ function update() {
     // idle after a resting state (done/needs/nothing) is just the "still waiting" reminder → drop and
     // leave the file as it was (recording it would bump ts and re-surface an already-cleared 已完成).
     // idle after a WORKING turn (prompt/resume) that never got a Stop = an ESC interrupt / walk-away —
-    // no Stop hook fires there, so idle is the only signal the turn ended. Without this the 进行中 dot
-    // sticks forever; treat it as a soft end and clear the pane (and its @claude_dot, below).
-    if (prevSrc === 'prompt' || prevSrc === 'resume') { delete obj[pane]; cleared = true; }
+    // no Stop hook fires there, so idle is the only signal the turn ended. Without this the pane would
+    // stay latched at 进行中 forever; treat it as a soft end and clear the pane.
+    if (prevSrc === 'prompt' || prevSrc === 'resume') { delete obj[pane]; }
     else return;                                             // resting → drop without writing
   } else if (src === 'end') {
     delete obj[pane];                                        // SessionEnd (clean exit) → drop the 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 {
-    obj[pane] = { ts: Number(ts) || 0, src, host, payload };
+    // 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 } : {}) };
   }
   const tmp = `${file}.${process.pid}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(obj));
@@ -72,21 +83,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 */ } }
-
-// tmux 页签状态色点（事件驱动）：把本次事件的状态色 markup 写进该 pane 所在窗的 @claude_dot 选项。
-// tmux 的 window-status-format 只读 #{@claude_dot}（纯查表、不跑任何 shell），所以稳态零重绘——只有
-// 状态真变化（即本 hook 触发的这一刻）才写一次、才重绘一次，不轮询、不卡。详见 tmux/README.md。
-// best-effort + 1s 超时：不在 tmux / tmux 不可达都静默忽略，永不阻塞或失败 Claude。
-function claudeDot(s, p) {
-  if (s === 'stop') return '#[fg=#2e7d46]●#[default] ';                              // 已完成 绿
-  if (s === 'prompt' || s === 'resume') return '#[fg=#2f6fed,blink]●#[default] ';   // 进行中 蓝闪
-  if (s === 'permreq') return '#[fg=#e0a020]●#[default] ';                           // 需要你 橙
-  if (s === 'notify' && p && p.notification_type === 'permission_prompt') return '#[fg=#e0a020]●#[default] ';
-  return null; // 其它无法分类 → 不动该窗的点（end 在下方单独清空）
-}
-try {
-  const dot = (src === 'end' || cleared) ? '' : claudeDot(src, payload);
-  if (dot !== null) {
-    require('node:child_process').execFileSync('tmux', ['set-option', '-w', '-t', pane, '@claude_dot', dot], { stdio: 'ignore', timeout: 1000 });
-  }
-} catch { /* 不在 tmux / tmux 不可达 → 忽略 */ }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "Mobile vibe coding — drive your real tmux session (and Claude Code) from your phone.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -24,7 +24,6 @@
     "bin",
     "src",
     "hooks",
-    "tmux",
     "public",
     "README.zh-CN.md"
   ],