handmux 0.22.1 → 0.24.0

package/README.md

@@ -68,15 +68,15 @@ 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, native Goal lifecycle cards, and session status; setting or restarting a Goal creates a fresh active native Goal, immediately shows its user-side card on the right, and starts Codex's built-in continuation. An active or paused Goal stays beneath the live read-only turn task list, Codex terminal feedback stays with its originating turn on the left, and every entry opens the same Bottom Sheet. The current Goal uses one equal-width iOS-style action row; clearing it removes the resident Goal and closes the sheet, while its historical chat card remains. The current terminal Goal can be edited before restarting. 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. The queue and delivery receipts survive Handmux restarts, and uncertain sends are reconciled before retrying. 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.
+- **Command & chat modes** — switch between direct terminal input and natural-language agent chat, with direct Alt and Space keys on the mobile command keyboard and 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.
 - **Script push** — notify your phone from any script or CI step with `handmux push`; target all devices, a named session, or a specific device.
 - **Workspace recovery** — handmux keeps the metadata needed to restore your latest tmux workspace after a computer or tmux-server restart, without replacing existing sessions.
 - **Git viewer** — changes / commit history / any branch / full-screen colored diff, multi-repo tabs, read-only, never touches your tree.
 - **Web Preview for URLs and static folders** — preview URLs by phone or computer proxy, or open an isolated static folder, with narrow/wide page widths and zoom; computer proxy can also request a mobile or desktop site version. It embeds pages rather than replacing a full browser.
-- **Docs** — tap a path in the terminal to open it; Markdown rendered, font zoom, sentence-by-sentence read-aloud.
+- **Docs** — tap recognized text-file paths in the terminal to open them, regardless of extension; ordinary slash-separated prose stays plain. Markdown rendered, font zoom, sentence-by-sentence read-aloud. Binary files stay download-only.
 - **Mobile select & copy** — long-press to select in the terminal, drag iOS-style handles to fine-tune, copy the selection / a whole line / a whole paragraph.
 - **Files both ways** — multi-select upload from the chat box, download, share in, copy any absolute path.
 - **Ideas — catch every one** — a thought the moment it strikes: a per-window idea/to-do list, jot one by voice and drop it straight into the prompt.

package/README.zh-CN.md

@@ -68,15 +68,15 @@ handmux start --tunnel cloudflare   # 即时公网地址(自动装 cloudflared)
 ## 功能一览
 
 - **Claude Code / Codex 深度**——收件箱状态台账、拇指批授权批计划，以及所有设备共享的本机最新 agent 用量。
-- **对话视图（实验性）**——用 Markdown 气泡、彩色工具 diff 和点按回答卡片把 Claude 会话变成移动端对话，可在设置中开启并随时切回终端。
+- **对话视图**——通过 App Server 用流式 Markdown 气泡、工具卡、原生 Goal 生命周期卡片和实时状态操作 Codex CLI；设置或重新开始会创建全新的 active 原生 Goal，立即在右侧显示用户侧卡片并启动 Codex 自带的自动续跑。进行中或暂停的 Goal 常驻在实时任务列表下方，Codex 终态反馈留在对应回合并靠左，所有入口统一打开同一个 Bottom Sheet；当前 Goal 使用 iOS 风格单行等分操作，清除后会移除常驻目标并关闭详情，已经发生的历史卡片仍保留；当前终态 Goal 可修改内容后重新开始。长回答会稳定在开头供阅读，用户可随时回到最新内容；支持现有 pane 原位接入和回复期间可编辑的服务端消息队列，队列和发送回执会跨 Handmux 重启恢复，并在不确定投递后先对账再重试。Claude Code 对话是独立开启的实验性功能。
 - **实时终端 + 电脑键盘**——在手机和电脑上实时操控同一个 tmux pane，支持历史滚动、弱网回退、物理键盘直输和原生复制粘贴。
-- **命令 / 聊天双模式**——在终端直输与自然语言对话间切换，并用跨设备同步的快捷栏快速操作。
+- **命令 / 聊天双模式**——在终端直输与自然语言对话间切换；手机命令键盘提供直接可用的 Alt 与空格键，并可用跨设备同步的快捷栏快速操作。
 - **更新后重新加载客户端**——服务端更新完成后，在设置里点「重新加载应用」即可载入新版客户端，无需退出主屏应用再重新打开。
 - **脚本推送**——用 `handmux push` 从脚本或 CI 步骤推消息到手机,可指定全部设备、某个会话或某台设备。
 - **工作区恢复**——handmux 静默保存必要元数据，在电脑或 tmux server 重启后恢复最新工作区，绝不替换现有会话。
 - **Git 查看器**——改动 / 提交历史 / 任意分支 / 全屏彩色 diff,多仓库分页,只读不动工作区。
 - **网页预览器**——用手机直连或电脑代理预览网址，也可隔离打开静态目录，支持窄屏 / 宽屏和缩放；电脑代理还可向网站请求手机版或电脑版。它只嵌入网页，不替代完整浏览器。
-- **文档**——终端里点路径即开;Markdown 排版、字号缩放、逐句高亮朗读。
+- **文档**——终端里明确识别出的文本文件路径不分扩展名均可点开，普通斜杠文字保持纯文本；支持 Markdown 排版、字号缩放、逐句高亮朗读，二进制文件仍只下载。
 - **选中 · 拷贝**——终端里长按选中,拖 iOS 式手柄精调,一键拷贝选区 / 整行 / 整段。
 - **文件双向传**——聊天框多选上传、下载、系统分享进来、复制绝对路径。
 - **想法 · 随想随记**——不错过任何点子:每窗口一份想法清单,灵感一冒就记(能语音速记),一点填进输入框。