ccg_bridge

v0.2.0 — Phase 1: 异步子进程执行 + WebSocket 传输 + 会话持久化

CCG = Claude Code (skills) + Codex + Gemini CLI.

推荐主路径（A 模式）：Claude Code 通过 skills 调用 ccg ask-async/pend，以异步方式完成跨模型协作（优先追求”快、稳”）。

这个仓库包含 CCG Bridge 的运行时代码与设计文档，并提供基于 MkDocs 的文档站点配置，便于本地预览和后续发布。

v0.2.0 主要变更

• SubprocessDriver：以 asyncio.create_subprocess_exec 异步执行 Provider CLI，替代原有 stub 实现
• 双传输层：UDS（~/.ccg/bridge.sock，CLI 主通道）+ WebSocket（ws://localhost:9801，Web UI / 订阅）
• 会话持久化：Session 自动保存到 .ccg/sessions/，重启后可恢复
• WebSocketClient：bridge_client.py 提供 request（无重试）、request_readonly（重试）、subscribe、pend_with_catchup 等方法

安装（全局推荐）

通过 npm 全局安装（需要 Node >=18；并要求本机可用 python3/python 用于创建 venv）：

npm i -g ccg_bridge
ccg version

首次安装会把 Python 运行时安装到 ~/.ccg/npm/ccg_bridge/venv。新增依赖（websockets>=12.0、aiofiles>=24.1.0）会随安装自动拉取，无需手动操作。

A 模式快速开始（推荐：快、稳）

前提：本机已安装并登录 codex 与 gemini CLI，且 Claude Code 可用。

在项目根目录：

# 一键启动：确保 bridge + 安装/更新 Claude Code skills
ccg
# 或：ccg up --project-root .

在 Claude Code 内（分两次发送，异步更快）：

/ccg-ask gemini "Reply with exactly: G-OK"
/ccg-pend gemini --wait 120

/ccg-ask codex "Reply with exactly: C-OK"
/ccg-pend codex --wait 120

说明：

• ccg tmux 是 commander/tmux（B 模式）路径，不是 A 模式必需；A 模式不需要开 tmux 三窗口。
• 结果持久化在 <project>/.ccg/tasks/<task_id>.json；/ccg-pend 默认按 last_submitted 精确等待最新任务。

预览文档站点（MkDocs）

在仓库根目录执行：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs serve

然后打开 http://127.0.0.1:8000/。