handmux 0.9.1 → 0.10.0

package/README.md

@@ -16,7 +16,7 @@ handmux is more than a terminal on your phone. It puts the *same* live **tmux**
   <em>Real phone browser, real panes — say what you need and Claude Code writes it, then tap a filename to preview (left); a push pings you when needed, and you review the git repo &amp; each agent's usage (right).</em>
 </p>
 
-**[📖 Docs](https://handmux.com/docs.html)** · **[📝 Changelog](CHANGELOG.md)** · **[📦 npm](https://www.npmjs.com/package/handmux)**
+**[📖 Docs](https://handmux.com/docs)** · **[📝 Changelog](CHANGELOG.md)** · **[📦 npm](https://www.npmjs.com/package/handmux)**
 
 ## Quick start · about a minute
 
@@ -35,7 +35,7 @@ Want to reach it from **anywhere**? Add one flag for a free public HTTPS link:
 handmux start --tunnel cloudflare   # instant public URL (cloudflared auto-installed)
 ```
 
-> Tunnel types, self-hosting, Windows/WSL2, and the full command & flag reference → see the **[docs](https://handmux.com/docs.html)**.
+> Tunnel types, self-hosting, Windows/WSL2, and the full command & flag reference → see the **[docs](https://handmux.com/docs)**.
 
 ## Why handmux
 
@@ -64,14 +64,14 @@ LAN-only by default, nothing exposed. To reach it from outside, just ask: **does
 - **Yes** (cloud box / public IP / forwarded port) — no tunnel needed, connect directly; fastest and most private.
 - **No** — open a tunnel: `cloudflare` (zero-config, up in seconds, but its public nodes can be slow or unreliable in some regions) · `cloudflare-named` (your own domain, steadier) · `ssh` self-hosted (through your own server — the pick where Cloudflare is unreliable, e.g. mainland China).
 
-> Tunnel config, server-side reverse proxy, autostart, voice/push credentials, and port previews → see the **[docs](https://handmux.com/docs.html)**.
+> Tunnel config, server-side reverse proxy, autostart, voice/push credentials, and port previews → see the **[docs](https://handmux.com/docs)**.
 
 ## Requirements
 
-Your computer needs **Node ≥ 18** and **tmux ≥ 3.0**; the phone just needs a browser. On **Windows**, run it inside **WSL2** (a real Linux kernel + real tmux) — see the [docs](https://handmux.com/docs.html#windows).
+Your computer needs **Node ≥ 18** and **tmux ≥ 3.0**; the phone just needs a browser. On **Windows**, run it inside **WSL2** (a real Linux kernel + real tmux) — see the [docs](https://handmux.com/docs#windows).
 
 ## More
 
-**[📖 Docs](https://handmux.com/docs.html)** · **[📝 Changelog](CHANGELOG.md)** · **[🔒 Security](SECURITY.md)** · License **AGPL-3.0**
+**[📖 Docs](https://handmux.com/docs)** · **[📝 Changelog](CHANGELOG.md)** · **[🔒 Security](SECURITY.md)** · License **AGPL-3.0**
 
 Found a security issue? Please report it privately (see [SECURITY.md](SECURITY.md)), not via a public issue.

package/README.zh-CN.md

@@ -16,7 +16,7 @@ handmux 不只是把终端搬上手机。它把你电脑上**正跑着的 tmux
   <em>真实手机浏览器、真实 pane——左:说出需求,Claude Code 直接写好,点文件名即可预览;右:需要你时推送提醒,查看 git 仓库与各 agent 用量。</em>
 </p>
 
-**[📖 文档](https://handmux.com/docs.html)** · **[📝 更新日志](CHANGELOG.md)** · **[📦 npm](https://www.npmjs.com/package/handmux)**
+**[📖 文档](https://handmux.com/docs)** · **[📝 更新日志](CHANGELOG.md)** · **[📦 npm](https://www.npmjs.com/package/handmux)**
 
 ## 快速上手 · 约一分钟
 
@@ -35,7 +35,7 @@ handmux start        # 跑起来 —— 仅本机 / 同 wifi,不对外暴露
 handmux start --tunnel cloudflare   # 即时公网地址(自动装 cloudflared)
 ```
 
-> 隧道类型、自建、Windows/WSL2、完整命令与参数 → 见 **[文档](https://handmux.com/docs.html)**。
+> 隧道类型、自建、Windows/WSL2、完整命令与参数 → 见 **[文档](https://handmux.com/docs)**。
 
 ## 为什么是 handmux
 
@@ -64,14 +64,14 @@ handmux start --tunnel cloudflare   # 即时公网地址(自动装 cloudflared)
 - **有**(云主机 / 公网 IP / 已端口转发)—— 不用隧道,直接连,最快也最私密。
 - **没有** —— 开一条隧道:`cloudflare`(零配置秒通,但公共节点在国内常不稳定)· `cloudflare-named`(你的域名,更稳)· `ssh` 自建(接你自己的服务器,**国内网络首选**)。
 
-> 隧道配置、服务端反向代理、开机自启、语音 / 推送凭证、端口预览等细节 → 见 **[文档](https://handmux.com/docs.html)**。
+> 隧道配置、服务端反向代理、开机自启、语音 / 推送凭证、端口预览等细节 → 见 **[文档](https://handmux.com/docs)**。
 
 ## 环境要求
 
-电脑需 **Node ≥ 18** 与 **tmux ≥ 3.0**;手机只要浏览器。**Windows** 请装进 **WSL2**(真 Linux 内核 + 真 tmux)——见 [文档](https://handmux.com/docs.html#windows)。
+电脑需 **Node ≥ 18** 与 **tmux ≥ 3.0**;手机只要浏览器。**Windows** 请装进 **WSL2**(真 Linux 内核 + 真 tmux)——见 [文档](https://handmux.com/docs#windows)。
 
 ## 更多
 
-**[📖 文档](https://handmux.com/docs.html)** · **[📝 更新日志](CHANGELOG.md)** · **[🔒 安全](SECURITY.md)** · 许可证 **AGPL-3.0**
+**[📖 文档](https://handmux.com/docs)** · **[📝 更新日志](CHANGELOG.md)** · **[🔒 安全](SECURITY.md)** · 许可证 **AGPL-3.0**
 
 发现安全问题请私下报告(见 [SECURITY.md](SECURITY.md)),别开公开 issue。

package/bin/handmux.js

@@ -118,6 +118,7 @@ async function preflightSsh(cfg) {
 async function main() {
   switch (command) {
     case 'start': return start();
+    case 'open': return openCmd();
     case 'stop': stop(); return;
     case 'restart': { stop(); await sleep(600); return start(); }
     case 'status': return status();
@@ -469,6 +470,23 @@ async function maybeQr(url, st) {
   } catch { /* no qrcode-terminal — URL alone is fine */ }
 }
 
+// `open` is deliberately DECOUPLED from the server lifecycle: it never starts/stops anything. It's the
+// desk-side quick attach — `handmux open foo` attaches session foo (creating it if missing), including
+// sessions that were created from the phone. Inside tmux it refuses (don't nest tmux in tmux).
+function openCmd() {
+  const name = process.argv[3];
+  if (!name || name.startsWith('-')) { console.error(t('open.usage')); process.exit(2); }
+  if (process.env.TMUX) { console.error(t('open.insideTmux')); process.exit(1); }
+  const tmux = checkTmux();
+  if (!tmux.present) {
+    console.error(t('tmux.notFound'));
+    console.error(t('tmux.install', { hint: tmuxInstallHint() }));
+    process.exit(1);
+  }
+  const r = spawnSync('tmux', ['new-session', '-A', '-s', name], { stdio: 'inherit' });
+  process.exit(r.status ?? 0);
+}
+
 function help() {
   console.log(t('help.body'));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "handmux",
-  "version": "0.9.1",
-  "description": "A mobile vibe-coding cockpit — built on tmux: drive your live session, Claude Code & Codex from your phone.",
+  "version": "0.10.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",
   "author": "yuanyuanzijin",
@@ -47,5 +47,14 @@
   "devDependencies": {
     "supertest": "^7.0.0",
     "vitest": "^2.0.0"
-  }
+  },
+  "whatsNew": [
+    {"version":"0.10.0","date":"2026-07-06","zh":"升级前预览新功能 · 电脑 handmux open 接管","en":"Preview an update before installing · handmux open"},
+    {"version":"0.9.1","date":"2026-07-06","zh":"「添加到主屏」引导","en":"\"Add to Home Screen\" coach"},
+    {"version":"0.9.0","date":"2026-07-05","zh":"聊天输入框多行重做","en":"Multi-line chat composer redone"},
+    {"version":"0.8.0","date":"2026-07-05","zh":"快捷栏可自定义 · 上传体验重做","en":"Customizable quick-bars · upload redone"},
+    {"version":"0.7.0","date":"2026-07-03","zh":"新增「用量」页","en":"New \"Usage\" page"},
+    {"version":"0.6.0","date":"2026-07-02","zh":"新增 Codex 支持","en":"Codex support added"},
+    {"version":"0.5.0","date":"2026-06-28","zh":"首个公开版 · 多语言界面","en":"First public release · multi-language UI"}
+  ]
 }