Opal Bridge

opal-bridge
Part of OPAL (Open Portable Activity Layer) — 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 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

当前能力（main after v0.6.0）

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

- 双向 CC ↔ Codex：live claude --resume / codex resume 都验证通过
- 共享标题：在 CC 或 Codex 任一边重命名 session，对面 picker 自动跟进；CC custom-title / agent-name 会成为 Codex picker 的可读名称；不再产生重复文件
- Codex 搜索标题修复：强制重渲染时会把 session_index.jsonl 里的用户标题写回 state_5.sqlite，避免 session 仍在但搜索不到
- 自动镜像：CC Stop hook + Codex notify hook，每段对话结束自动同步到对面；或用 agent-resume watch 守护进程
- 历史修复同步：sync --force --include-active --days 365 可重渲染旧镜像，修复 hook 未运行期间留下的短 context
- 空会话降噪：没有 replayable context 的 Codex/CC 源不会生成空镜像；已生成的空镜像会被移除
- MCP server：agent-resume mcp serve 暴露 6 个工具给任意 MCP host（Claude Desktop / Cursor / Cline / …）
- 6 核心工具映射：Bash / Read / Glob / Grep / WebSearch / 大部分 metadata
- apply_patch 双向：CC Edit/Write/MultiEdit ↔ Codex apply_patch grammar，多 op envelope 自动拆为多个 canonical ToolCall
- subagent inline：自动扫 /subagents/，按 description 匹配后拼进主线
- compact_boundary 双向：CC compact_boundary + isCompactSummary user ↔ canonical SummaryCompaction ↔ Codex compacted / context_compaction
- shell 命令模式识别：Codex 端的 cat -n / sed / head / tail / rg --files 反向回 canonical Read/Glob，避免 round-trip 退化
- realpath + NFC：CC…