Skip to content

Releases: hangox/wezterm-agent-bridge

Release list

v0.3.1 Windows socket 分隔符修复

v0.3.1 Windows socket 分隔符修复 Latest
Latest

Choose a tag to compare

View all tags
@hangox hangox released this 19 Sep 11:04
v0.3.1
3e7f3cb

修复

Windows 下 WezTerm 给 pane 子进程设置的 WEZTERM_UNIX_SOCKET 会混用 / 和 \，而本项目自身发现 socket 时用的是纯反斜杠路径，朴素字符串比较把同一个 socket 判定成两个不同的，导致健康的 bridge daemon 被拒绝复用，it2 session 系列命令全部失败。这是 Windows 上 agent-team 无法创建外部队友的根因之一。

ensureDaemon() 的 socket 匹配逻辑改为按平台归一化后比较，只在 win32 上做分隔符归一化，POSIX 不受影响。新增三条回归测试覆盖：同 socket 混合分隔符应匹配、真正不同的 socket 仍应拒绝、非 Windows 不做归一化。

已在真实 Windows 机器上部署验证：socket mismatch 消失，split/run/read/close 完整 pane 生命周期跑通。

Full Changelog: v0.3.0...v0.3.1

Assets 2
Loading

v0.3.0 Windows 实验适配

v0.3.0 Windows 实验适配 Pre-release
Pre-release

Choose a tag to compare

View all tags
@hangox hangox released this 09 Sep 07:52
v0.3.0
3cf4480

独立开源首版

将 Claude Code 的 it2（iTerm2 兼容）终端控制接口桥接到 WezTerm，支持真实 pane 的创建、命令发送、读取、聚焦与关闭。本项目不代理模型请求，也不提供模型账号或 API Key。

本版内容

  • 支持 zsh 与 PowerShell 7 初始化，Windows 生成 it2 / it2.cmd / it2.ps1 入口。
  • 增加默认关闭的 Windows BASH_ENV 探测适配，修正 MSYS 路径与退出阶段 ANSI 噪声对官方路径解析的影响。
  • Windows 启动命令中的环境变量通过本机临时 JSON 传递，避免直接出现在终端输入文本中；实际保护依赖本机目录权限和 NTFS ACL。
  • daemon 健康检查增加鉴权与 PID 校验；请求使用总时限；不根据过期状态文件自动终止进程；错误诊断不输出完整含密钥状态。
  • 移除未采用的 SEA 实验代码及相关依赖，发行包包含自包含测试夹具和真实 Windows 运行截图。

验证

  • macOS 与真实 Windows：53 项自动化测试通过。
  • GitHub Actions：Ubuntu、Windows、macOS 三平台构建、类型检查与测试全部通过。
  • 真实 Windows 探测链：原始输出 → 官方最后非空行解析 → 原生 it2.cmd session list 执行成功。
  • 真实 developer/tester 双队友演示：TypeScript 实现与 3 个业务断言通过，已提供实际截图与同步后端记录。

CI：https://github.com/hangox/wezterm-agent-bridge/actions/runs/34325702735

已知边界

Windows 适配是实验性能力，针对 Claude Code 2.1.263 验证，需要显式启用实验开关并使用隐藏参数 --teammate-mode iterm2；不保证后续 CLI 版本保留该接口。具体步骤见 README。

真实演示中 tester 正常退出，developer 因本轮任务约束仍拒绝关闭；该负例和缺失的开场截图均如实记录，没有将其写成整队正常关闭成功。截图中的 CLI 自动更新失败提示原样保留，不作为业务断言结果。

本项目不内置完整的 Windows profile 管理器。独立模型/provider 配置由用户自己的外部启动包装脚本负责。macOS/Linux 当前原样发送命令，启动环境变量可能出现在终端滚屏中，请注意凭据加载方式。

安装包

下载 wezterm-agent-bridge-0.3.0.tgz 后安装：

npm install -g ./wezterm-agent-bridge-0.3.0.tgz

SHA-256：115f0fd7b1f21330fb255edf5a2581aad17e1285fc82e96720357a7bddc01297

许可证：MIT。本次仅发布 GitHub Release，不向 npm registry 发布。

Loading