Skip to content

Codux 2.0.3

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Jul 07:25

中文

[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 / 下载说明

File / 文件 Usage 用途
codux-macos-aarch64.dmg Apple Silicon Mac stable release Apple Silicon Mac 正式版本
codux-macos-x86_64.dmg Intel Mac stable release Intel Mac 正式版本
codux-windows-x86_64-setup.exe Windows 64-bit installer Windows 64 位安装包
codux-macos-aarch64 Apple Silicon Mac headless agent Apple Silicon Mac 主机端
codux-macos-x86_64 Intel Mac headless agent Intel Mac 主机端
codux-linux-x86_64 Linux x86_64 headless agent Linux x86_64 主机端
codux-linux-aarch64 Linux ARM64 headless agent Linux ARM64 主机端
codux-windows-x86_64.exe Windows 64-bit headless agent Windows 64 位主机端