Codex Host Bridge 是运行在 Windows 宿主机上的 WPF 桌面应用,用于将远程 Codex 客户端(Linux、macOS 或其他 Windows 节点)连接到本地 Codex App Server。远程节点通过 Tailnet 连接到 Bridge Gateway,经 Gateway 转发后,在 Windows 宿主机配置的项目目录中创建和操作 Codex 会话。
当前基线: v0.4.40
项目类型: 开发工具平台
开发周期: 2024-2025
项目状态: 生产使用
Windows 桌面 Codex 可以 SSH 到其他主机,实现从 Windows 到远程主机的运维操作。但也存在反向需求:让 Linux 或 macOS 的 Codex 客户端加入 Windows 宿主的项目上下文。
本项目提供了这个反向通道:
远程 Codex 客户端
|
| Tailnet WebSocket
↓
Windows Codex Host Bridge Gateway
|
| 本地回环转发
↓
Windows Codex App Server
|
↓
Windows 宿主项目目录
- 维护生命周期和就绪状态
- 处理启动、停止、重启、端口冲突
- 维护连接数、节点连接数、活动追踪
- 连接报告和验证脚本
远程节点(Linux/macOS)
↓
永久代理
↓
Windows Tailnet Gateway
↓
Windows Codex App Server
↓
Windows 项目目录
- 跨平台远程开发支持
- 基于会话的连接转发
- 节点准入和访问控制
- 状态观测和只读导出
- C# / .NET
Codex-Host-Bridge/
├── src/CodexHostBridge/ # Windows WPF Bridge 主程序
├── nodes/linux/ # Linux 节点入驻材料
├── docs/testing/ # 测试计划和验收证据
├── docs/release/ # 版本发布记录
├── docs/plans/ # 项目计划和结案记录
├── docs/integration/ # AgentMeshOS 状态契约
└── artifacts/releases/ # 发布程序和验证材料
这个工具桥接了不同操作系统的开发环境,实现远程 AI 辅助开发工作流。