# ccg_bridge

**Repository Path**: jasonchan0754/ccg_bridge

## Basic Information

- **Project Name**: ccg_bridge
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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）：

```bash
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 可用。

在项目根目录：

```bash
# 一键启动：确保 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）

在仓库根目录执行：

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

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