Opal Bridge

opal-bridge

Part of [**OPAL**](https://github.com/1va7/opal) (**O**pen **P**ortable **A**ctivity **L**ayer) — the cross-agent CLI session translator subsystem.

**main after v0.6.0** — title sync across CC↔Codex twins, Codex picker/search DB title fixes, no duplicate files on rename. See [CHANGELOG.md](CHANGELOG.md) for full version history.

跨 agent 的 session 翻译与 resume 桥。

要解决的问题

不同 agent harness（Claude Code / Codex / Hermes / 公司内部 agent）各自把 session 存成自己的 jsonl 格式，且 tool schema 互不兼容。导致一个项目在某一个 agent 里做到一半，无法在另一个 agent 里 `--resume` 接着干，只能把人工摘要重新粘进去。

方案

中间走 canonical session format，每个 agent 配一对 adapter：

• ingest: 该 agent 的 session jsonl → canonical
• render: canonical → 该 agent 可被 --resume 加载的 session 文件

Quick start

# 安装
python3 -m venv .venv && .venv/bin/pip install -e .

# 列出最近的 CC session
.venv/bin/python -m agent_bridge.cli list -n 10

# 双向翻译 + 一键 smoke 验证
# CC → Codex：
.venv/bin/python -m agent_bridge.cli smoke \
    ~/.claude/projects//.jsonl \
    --prompt "Reply with: WORKS"
# Codex → CC：
.venv/bin/python -m agent_bridge.cli smoke --from codex \
    ~/.codex/sessions/YYYY/MM/DD/rollout-...UUIDv7.jsonl \
    --prompt "Reply with: WORKS"

# 仅翻译（不 smoke），双向都支持：
.venv/bin/python -m agent_bridge.cli translate \
    --from claude-code --to codex \
    --subagent-strategy inline \
    ~/.claude/projects//.jsonl

.venv/bin/python -m agent_bridge.cli translate \
    --from codex --to claude-code \
    ~/.codex/sessions/YYYY/MM/DD/rollout-...UUIDv7.jsonl

# 拿到结果后直接复制粘贴对应 resume 命令：
codex exec resume  "你的新指令"          # 翻成 Codex
claude --resume  -p "你的新指令"          # 翻成 CC（在原 cwd 下）

# 历史补同步 / 修复旧的短镜像：
.venv/bin/python -m agent_bridge.cli sync \
    --direction both --days 365 --include-active --force

当前能力（main after v0.6.0）

✅ **双向翻译 + 自动镜像 + 共享标题** — 完整版本历史见 [CHANGELOG.md](CHANGELOG.md)

• 双向 CC ↔ Codex：live claude --resume / codex resume 都验证通过
• 共享标题：在