中文

[2.0.3] - 2026-07-21

新增

• 新增 Agent worktree 编排能力，AI 工具可通过 codux-worktree 创建隔离子 worktree、运行子终端、评审变更、合并结果并移除任务 worktree，形成完整闭环。
• 新增 worktree 任务持久化与 hosted runtime 路由，桌面端、WSL、远程主机和 headless Agent 的子任务终端都可以在父任务等待时继续查看。
• 新增 Oh My Pi runtime 支持，包括 shell wrapper、托管配置、runtime 探测、会话恢复，以及 AI 用量/历史解析。
• 新增 Kimi Code 0.27 兼容，包括 runtime 探测、wrapper 启动、会话路径和 Token 用量解析。
• 项目创建/编辑窗口新增项目级自定义环境变量，新开的本地、WSL、远程与 AI CLI 终端会继承这些变量。
• 新增 Codux runtime 协议变量保护，项目环境变量不能覆盖 CODUX_* 和 DMUX_* 保留值。

调整

• 重构 AI 历史与 Token 统计链路，统一处理标准化会话来源、外部会话路径、缓存桶、hosted runtime 元数据和恢复会话。
• 移动端终端恢复对齐桌面端与 headless Agent 使用的共享 baseline 和输出水位协议。
• Homebrew cask 发布改为使用稳定公开的 DMG 文件名生成下载地址和 SHA256。
• 补充移动端 2.0.3 更新说明，对齐本次桌面端发布中的终端恢复修复。

修复

• 修复移动端切换项目、worktree 和运行中终端后出现历史重复、旧内容残留、空白区域和输出序列缺口的问题。
• 修复移动端缓存终端切换时重复回放完整 baseline 的问题，只有无缓存或序列缺口时才请求权威 baseline。
• 修复远程与移动端在项目/worktree 变化、主机重连、切换运行中终端后的 viewport ownership 恢复。
• 修复 Agent worktree 子任务权限继承问题，嵌套 AI 任务可按预期启动，不再反复要求手动审批。
• 修复 Agent worktree 语义幂等问题，同一分支/同一任务重试会复用已有 operation，不再创建重复 worktree 或返回不可交付的 operationId。
• 修复 Agent worktree 合并/移除清理、终端持久化，以及本地、远程、WSL、headless Agent 目标下的命令路由。
• 修复 Codex、Claude Code、Kimi、Oh My Pi、缓存输入桶、hosted runtime 和恢复的外部会话下的 AI 用量汇总。
• 修复未配置可用记忆提取 Provider 时自动提取队列反复失败的问题，并保留待处理任务直到 Provider 可用。
• 修复终端 workspace 重复重绘导致 CPU 升高、长任务运行时 GUI 看起来卡死的问题。
• 修复 Homebrew 发布元数据误从带版本号或 debug 产物生成，而不是使用稳定公开 DMG 文件的问题。

English

[2.0.3] - 2026-07-21

Added

• Added agent worktree orchestration with codux-worktree, allowing AI tools to create isolated child worktrees, run the child terminal, review changes, merge results, and remove the task worktree in one workflow.
• Added worktree task persistence and hosted-runtime routing for desktop, WSL, remote hosts, and headless Agents so child-task terminals remain inspectable while the parent task waits.
• Added Oh My Pi runtime support, including shell wrappers, managed config, runtime probing, session restore, and AI usage/history parsing.
• Added Kimi Code 0.27 compatibility for runtime detection, wrapper launch, session paths, and token usage parsing.
• Added project-level custom environment variables in the project create/edit dialog. New local, WSL, remote, and AI CLI terminals inherit these variables.
• Added protection for Codux runtime protocol variables so project environment variables cannot override reserved CODUX_* and DMUX_* values.

Changed

• Reworked the AI history and token accounting pipeline to use normalized session sources, external session paths, cache buckets, hosted runtime metadata, and restored sessions consistently.
• Aligned mobile terminal restoration with the shared desktop/headless Agent baseline and output-watermark protocol.
• Updated Homebrew cask publishing to use stable public DMG asset names for download URLs and SHA256 generation.
• Prepared the mobile 2.0.3 release notes for the terminal restoration fixes included with this desktop release.

Fixed

• Fixed duplicated or stale mobile terminal output after switching projects, worktrees, and running terminals, including blank regions, stale fragments, and sequence-gapped output.
• Fixed cached terminal switching so existing mobile sessions do not replay their full baseline unless an authoritative baseline is required.
• Fixed remote and mobile viewport ownership recovery after project/worktree changes, host reconnects, and running-terminal switches.
• Fixed agent worktree child-task permissions so nested AI tasks can run with the expected launch mode without repeated manual approval.
• Fixed agent worktree semantic idempotency so retrying the same branch/task reuses the existing operation instead of creating duplicate worktrees or unusable operation IDs.
• Fixed agent worktree merge/remove cleanup, terminal persistence, and command routing for local, remote, WSL, and headless Agent targets.
• Fixed AI usage totals across Codex, Claude Code, Kimi, Oh My Pi, cached input buckets, hosted runtimes, and restored external sessions.
• Fixed automatic memory extraction churn when no eligible provider is configured, preserving queued work until a provider becomes available.
• Fixed terminal workspace redundant redraws that could push CPU high and make the GUI appear frozen during long-running terminal activity.
• Fixed Homebrew release metadata generated from versioned/debug assets instead of the stable public DMG files.

Downloads / 下载说明

中文

[2.0.2] - 2026-07-16

调整

• WSL 设置现在会显示已安装 Codux Runtime 的版本与 stdio 协议；需要更新时同时显示当前桌面端要求的协议版本。

修复

• 修复旧版记忆数据库升级后因缺少 memory_entries.module_key 列导致记忆提取全部失败的问题。
• 修复本地、WSL、远程与 Windows 设备路径在项目、文件、Git、worktree、终端、AI 历史和记忆中的跨平台路径标识不一致问题。
• 修复移动端终端在滚动、调整尺寸或快速切换项目、worktree 与运行中终端后出现历史重复、顶部残片、空白区域和恢复状态不一致的问题。
• 修复远程终端 baseline，保留历史、生命周期水位与可见屏幕现在会原子捕获，不扩大 scrollback 上限，也不会重复回放 baseline 已覆盖的实时输出。

English

[2.0.2] - 2026-07-16

Changed

• WSL Settings now shows the installed Codux Runtime version and stdio protocol, including the protocol required by the current desktop build when an update is needed.

Fixed

• Fixed memory extraction failures after upgrading an existing database that predates the memory_entries.module_key column.
• Fixed cross-platform path identity for local, WSL, remote, and Windows device paths across projects, files, Git, worktrees, terminals, AI history, and memory.
• Fixed mobile terminal history duplication, stale fragments, blank regions, and inconsistent restores after scrolling, resizing, or rapidly switching projects, worktrees, and running terminals.
• Fixed remote terminal baselines so retained history, lifecycle watermarks, and the visible screen are captured atomically without increasing scrollback limits or replaying already-covered live output.

Downloads / 下载说明

中文

[2.0.1] - 2026-07-15

调整

• 完善 Windows 原生 WSL 项目文档，包括发行版配置、Codux Runtime 一键安装与更新，以及从 WSL 目录添加项目的使用方式。
• 改进恢复会话、Codex 子智能体、缓存 Token、托管运行时与宠物成长的 AI 历史和用量统计，同时保留现有宠物等级。

修复

• 修复 AI CLI 被中断、异常退出或未发送结束进度事件便返回 Shell 后，终端、worktree 与项目状态仍持续显示运行中的问题。
• 修复复制终端文本时视觉软换行被错误插入换行符的问题，同时保留真实换行，并覆盖远程终端。
• 修复 Windows 窗口控制与 WSL 项目切换问题，包括首次激活延迟，以及运行时变化后终端仍绑定旧状态的问题。
• 修复外部项目目录恢复、终端文字对比度、状态动画负载，以及终端“收起到侧栏”提示未本地化的问题。

English

[2.0.1] - 2026-07-15

Changed

• Documented native Windows WSL projects, including distribution setup, one-click Codux Runtime installation and updates, and project selection from WSL directories.
• Improved AI history and usage accounting across restored sessions, Codex subagents, cache tokens, hosted runtimes, and pet progression while preserving existing levels.

Fixed

• Fixed terminal, worktree, and project agent indicators remaining stuck in a working state after an AI CLI was interrupted, exited unexpectedly, or returned to the shell without a closing progress event.
• Fixed copied terminal text gaining newlines at visual soft wraps while preserving real line breaks, including remote terminals.
• Fixed Windows window controls and WSL project switching, including delayed first activation and stale terminal bindings after runtime changes.
• Fixed external project-directory recovery, terminal text contrast, status animation load, and the terminal collapse tooltip localization.

Downloads / 下载说明

中文

[2.0.0] - 2026-07-13

新增

• 新增跨设备工作区，在 Codux 桌面端、移动端与 headless Agent 之间统一控制项目、文件、Git、worktree、终端、AI 会话、记忆和主机监控。
• 新增 Windows 本机 WSL 项目支持，包括发行版发现、Codux Runtime 一键安装与更新、WSL 文件浏览、Git/worktree 操作和持久终端会话。
• 新增终端列表搜索与全选、更完整的终端协议支持、项目/worktree/终端 AI 状态指示、AI 用量图表、轮转诊断日志，以及日语和韩语文档。

调整

• 将本机、WSL 和远程项目统一到单一 runtime target 架构，文件、Git、worktree、终端和项目活动使用一致的路由与生命周期规则。
• 桌面端、移动端与 Agent 统一使用共享协议模型、明确的订阅归属、终端 viewport 接管和稳定的 latest 下载资源。
• Iroh 升级至 1.0.2，并缩短主控端启动、回到前台、切换主机和 mDNS 关闭等待时间。

修复

• 修复 Windows、macOS、Linux、WSL 和远程主机上的终端稳定性问题，包括快速切换 worktree、主机重启、失效 PTY、ConPTY 光标与重绘、Shell 环境、文件描述符压力和重复初始化。
• 修复断线、鉴权变化、删除设备、应用进入后台和主机重启后的远程/移动端恢复，避免项目、worktree、终端、AI 统计、记忆、文件和 Git 状态残留或空白。
• 修复重复重绘、轮询、动画和发现任务造成的空闲与运行中 CPU 压力，包括项目/worktree/终端状态动画卡顿；同时完善运行时 panic、轮转日志和终端诊断能力。

English

[2.0.0] - 2026-07-13

Added

• Added cross-device workspaces for controlling projects, files, Git, worktrees, terminals, AI sessions, memory, and host metrics across Codux Desktop, Codux Mobile, and headless Agents.
• Added local WSL project support on Windows, including distribution discovery, one-click Codux Runtime installation and updates, WSL file browsing, Git/worktree operations, and persistent terminal sessions.
• Added a terminal list with search and select-all, richer terminal protocol support, project/worktree/terminal AI status indicators, AI usage charts, rotated diagnostics, and expanded Japanese and Korean documentation.

Changed

• Unified local, WSL, and remote projects behind one runtime target architecture so files, Git, worktrees, terminals, and project activity follow the same routing and lifecycle rules.
• Unified desktop, mobile, and Agent resource synchronization around shared protocol models, explicit subscription ownership, terminal viewport handoff, and stable latest-download assets.
• Upgraded Iroh to 1.0.2 and reduced controller startup, foreground resume, host switching, and mDNS shutdown overhead.

Fixed

• Fixed terminal stability across Windows, macOS, Linux, WSL, and remote hosts, including rapid worktree switching, host restarts, stale PTY sessions, ConPTY cursor/redraw issues, shell environment handling, file-descriptor pressure, and duplicate initialization.
• Fixed remote/mobile recovery after disconnects, authorization changes, device removal, app backgrounding, and host restarts so project, worktree, terminal, AI statistics, memory, file, and Git state no longer remains stale or blank.
• Fixed idle and active CPU pressure from redundant repaint, polling, animation, and discovery work, including stuttering project/worktree/terminal status indicators; expanded runtime panic, rotating log, and terminal diagnostics for production failures.

Downloads / 下载说明

中文

[2.0.0-rc.9] - 2026-07-11

调整

• Iroh 升级至 1.0.2，并使移动端控制器运行时与进程级共享 endpoint 保持一致的生命周期。
• 简化桌面端、移动端与 headless Agent 的远程资源同步链路，统一订阅归属与清理规则。

修复

• 显著缩短移动端启动、回到前台和切换主机后的重连时间，连接进行中不再被重复中断并重新开始。
• 修复旧连接超时早于原生 Iroh 连接预算触发，导致移动端过早判定连接失败的问题。
• 加固远程鉴权变化、设备断连清理，以及终端、AI 统计、记忆、项目、worktree、文件和 Git 资源同步。

English

[2.0.0-rc.9] - 2026-07-11

Changed

• Upgraded Iroh to 1.0.2 and aligned the mobile controller runtime with the process-wide shared endpoint lifecycle.
• Simplified remote resource synchronization across desktop, mobile, and headless Agent with consistent subscription ownership and cleanup.

Fixed

• Significantly reduced mobile startup, foreground resume, and host-switch reconnect time by preserving an in-progress connection instead of restarting it.
• Fixed premature mobile connection failures caused by a legacy timeout expiring before the native Iroh connection budget.
• Hardened remote authorization changes, device disconnect cleanup, terminal synchronization, AI statistics, memory, project, worktree, file, and Git resource updates.

Downloads / 下载说明

中文

[2.0.0-rc.8] - 2026-07-10

调整

• login 等 AI CLI 管理命令现在会直接透传执行，resume / restore 等恢复命令仍会注入 Codux 启动上下文。
• 统一本地与远程终端的终端、worktree、项目生命周期汇总链路，并固定状态优先级。

修复

• 修复远程主机重启、设备重连、worktree 变化和过期 session 清理后的终端恢复问题，分屏不再继续绑定失效终端。
• 修复 worktree 终端清理与快速切换问题，保留已有终端布局，避免重复初始化或残留错误映射。
• 修复移动端创建终端的事务闭环，发送失败、Host 错误、进程立即退出、鉴权变化或传输断开后不再一直显示创建中。
• 修复 headless Agent 的设备断连清理，离线设备不再残留终端订阅、输出确认和 AI 统计 watcher。
• 修复 working 与 error 状态同时存在时生命周期汇总结果不稳定的问题，项目与 worktree 状态指示保持确定一致。

English

[2.0.0-rc.8] - 2026-07-10

Changed

• AI CLI management commands such as login now pass through directly, while resume and restore commands continue to receive Codux launch context.
• Unified terminal, worktree, and project lifecycle aggregation across local and remote sessions with deterministic status priority.

Fixed

• Fixed remote terminal recovery after host restarts, device reconnects, worktree changes, and stale session cleanup so panes no longer remain bound to dead terminals.
• Fixed worktree terminal cleanup and rapid switching so existing terminal layouts are preserved without duplicate initialization or stale mappings.
• Fixed mobile terminal creation transactions so send failures, host errors, immediate process exits, authorization changes, and transport disconnects cannot leave the UI stuck in a creating state.
• Fixed headless Agent disconnect cleanup by removing stale terminal subscriptions, output acknowledgements, and AI statistics watchers for offline devices.
• Fixed terminal lifecycle summaries when working and error states coexist, removing nondeterministic project and worktree indicators.

Downloads / 下载说明

中文

[2.0.0-rc.7] - 2026-07-09

修复

• 修复 Windows 下 Git 仓库识别问题，避免 safe.directory 权限提示或过期仓库缓存导致 Git 侧栏为空。
• 修复快速切换 worktree 时终端分屏被重新初始化的问题，布局变化会保留已有终端会话。
• 优化浅色主题下的终端文字对比度。
• 修复发布下载链接与更新元数据，确保 latest 公共资源链接在版本间保持稳定。

English

[2.0.0-rc.7] - 2026-07-09

Fixed

• Fixed Git repository detection on Windows when trusted-directory prompts or stale repository caches prevented the Git sidebar from loading.
• Fixed rapid worktree switching so terminal panes keep their existing sessions instead of being reinitialized during layout changes.
• Improved terminal text contrast on light themes.
• Fixed release download links and update metadata so latest public assets remain stable across releases.

Downloads / 下载说明

中文

[2.0.0-rc.6] - 2026-07-08

调整

• 终端、worktree 与项目的 agent 生命周期状态统一改为 OSC 驱动链路，终端状态事件会携带明确的项目与 worktree 作用域，上层只做汇总显示。

修复

• 修复远程主机重启后的终端死链问题。Windows 或远程主机恢复连接但旧 PTY 会话已不存在时，Codux 会用保存的启动配置重新创建稳定的远程终端，而不是继续绑定到失效 session。
• 修复远程 worktree 和项目状态指示，确保它们与终端列表使用同一套终端状态事件汇总。

English

[2.0.0-rc.6] - 2026-07-08

Changed

• Switched terminal, worktree, and project agent lifecycle indicators to a single OSC-driven status path, with terminal events carrying explicit project and worktree scope for clean aggregation.

Fixed

• Fixed remote terminal recovery after a host restart. When a Windows or remote host comes back online without the old PTY session, Codux now recreates the stable remote terminal from its saved launch configuration instead of leaving the pane bound to a dead session.
• Fixed remote worktree and project status indicators so they aggregate from the same terminal status events as the terminal list.

Downloads / 下载说明

中文

[2.0.0-rc.5] - 2026-07-07

新增

• 终端右键菜单新增复制、粘贴、全选，以及保留当前提示符的清屏操作。

调整

• RC 构建默认使用 stable 更新通道；stable 发布时也会同步刷新 beta manifest，避免 beta 通道安装停留在旧 beta 版本。
• 新增可选的原始终端输出捕获索引，排查终端渲染问题时可保留真实 PTY 分片边界。

修复

• 优化 Windows 终端启动环境，保留 SystemDrive、ProgramData 等核心系统变量，避免项目目录下生成字面量 %SystemDrive% 目录。
• 稳定 Windows ConPTY 和远程终端重绘，修复同步输出帧边界的光标跳动、主屏 TUI 恢复、baseline keyframe，以及较短历史重同步后的滚动恢复问题。
• 规范化 Windows 文件路径，避免 Explorer 和回收站辅助操作收到 \\?\ 前缀路径。
• worktree 删除改到后台线程执行，删除较大的 worktree 时不再卡住界面。

English

[2.0.0-rc.5] - 2026-07-07

Added

• Added a terminal right-click menu for copy, paste, select all, and prompt-preserving clear.

Changed

• RC builds now default to the stable update channel, and stable release publishing also refreshes the beta manifest so beta-channel installs do not remain pinned to older beta builds.
• Added an opt-in raw terminal capture index for diagnosing terminal rendering regressions with the original PTY chunk boundaries.

Fixed

• Improved Windows terminal startup by preserving core system environment variables such as SystemDrive and ProgramData, preventing literal %SystemDrive% directories from being created in project folders.
• Stabilized Windows ConPTY and remote terminal redraws, including cursor jumps at synchronized output frame boundaries, primary-buffer TUI recovery, baseline keyframes, and scroll restore after shorter history resyncs.
• Normalized Windows file paths before file operations so Explorer and recycle-bin helpers do not receive \\?\-prefixed paths.
• Moved worktree removal off the UI thread so deleting larger worktrees no longer freezes the interface.

Downloads / 下载说明

中文

[2.0.0-rc.4] - 2026-07-06

新增

• 扩展终端协议支持：新增 OSC 8 超链接、OSC 52 剪贴板写入、OSC 133 prompt 标记、OSC 1337 行内图片、kitty 键盘消歧、终端响铃通知、扩展下划线颜色、Nerd Font 符号、powerline 分隔符，以及 legacy/braille 字形渲染。
• 终端设置新增 shell 选择、行高、内边距配置，并支持将字号调低到 8px。

调整

• 将桌面端与运行时的大文件拆分为更聚焦的子模块，不改变行为，便于 review 和后续维护。
• 将「图片粘贴为路径」移动到终端设置卡片，并将桌面依赖切回官方 GPUI component 来源。

修复

• 提升 Git 操作在 worktree 和远程项目中的可靠性，覆盖修改最近提交说明、已有仓库初始化、分支切换、Quick Pick/Input 交互和失败弹窗。
• 提升 Windows 与 Linux 终端稳定性，修复粘贴快捷键、PowerShell wrapper 路径处理、隐藏控制台窗口、conhost 浅色主题识别，以及 Windows 文件预览关闭按钮问题。
• 修复终端非 ASCII 组合字符、Nerd Font 图标、powerline 分隔符，以及 reflow 后输入法光标位置的渲染问题。
• 优化已保存 SSH 的自动连接与重连、codux-ssh 非交互执行、SCP 支持，以及 agent 中继配置参数。

English

[2.0.0-rc.4] - 2026-07-06

Added

• Added broader terminal protocol support, including OSC 8 hyperlinks, OSC 52 clipboard writes, OSC 133 prompt marks, OSC 1337 inline images, kitty keyboard disambiguation, bell notifications, extended underline colors, Nerd Font symbols, powerline separators, and legacy/braille glyph rendering.
• Added terminal settings for shell selection, line height, padding, and smaller font sizes down to 8px.

Changed

• Split large desktop and runtime modules into focused submodules without behavior changes, improving reviewability and follow-up maintenance.
• Moved paste-images-as-paths into the terminal settings card and switched desktop dependencies back to the official GPUI component source.

Fixed

• Improved Git action reliability for worktrees and remote projects, including amend-last-message, existing-repo init, branch switching, Quick Pick/Input interactions, and visible failure dialogs.
• Improved terminal stability on Windows and Linux, including paste shortcuts, PowerShell wrapper path handling, hidden console windows, conhost light-theme detection, and Windows file-preview close behavior.
• Fixed terminal rendering for non-ASCII combining marks, Nerd Font icons, powerline separators, and IME cursor bounds during reflow.
• Improved saved SSH auto-connect/reconnect behavior, codux-ssh non-interactive execution, SCP support, and agent relay configuration flags.

Downloads / 下载说明