pickup
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ai-agent-bridge
读取另一个 AI 编码工具的会话:先给最新结论,不够再逐层展开。
两个概念分开看:
能读谁:已适配会话格式的工具 — Codex、Claude Code、WorkBuddy、CodeBuddy、EasyMint、DeepSeek Harness
能装谁:任何支持 MCP 的客户端都能挂 aab;aab 能自动写配置的是 EasyMint、DeepSeek Harness(全部 profile)、 WorkBuddy、Codex、Claude Code,其它客户端自己装(见下方「安装」)
典型场景:A 工具的额度用完了,让 B 读 A 的最后状态、由 B 自己接着干——不要去 resume A。
会话数据只读;唯一写入的是各客户端的 MCP 配置,由 install 完成,可用 --dry-run 预览。
npx -y @tianemon/ai-agent-bridge install # 探测本机已装的客户端并写入 MCP 配置
npx -y @tianemon/ai-agent-bridge doctor # 能读到谁的会话、哪个客户端已挂上安装后命令为 aab,别名 agent-bridge。零依赖,Node ≥ 18。
输出
■ Codex · 2026-10-25 10:03 · 续跑 4 段 · gpt-6.1-sol
会话 01a16729-0aed-7012 · 共 99 轮需求 · /Users/amon/dev/project/EasyMint
标题 解析视频并仿制 UI 风格
【level 1 · 最新进展(未收尾)】
第 99 轮 · 用户问:重新发布1.4.0
(该轮没有收尾结论——会话可能中断、仍在运行,或最后一条只是进展旁白)
我会把这些界面修正并入 1.4.0,完成发版检查后替换标签和 Release,触发三平台重新构建。
── 退路:最近一条结论在第 98 轮(约 +93 token)──
已实现:Mint 头像和名称移到回复上方;去掉回复气泡底色;只有结论保留复制、钉住、重新回答。
── 不够就再看一层(同一会话再调一次,换个 level)──
level=2 最近 3 轮问答 ≈ 合计 551 token(比当前多 368)
level=3 全部需求与结论(每轮一行) ≈ 合计 4130 token(比当前多 3947)
level=4 命令 / 文件 / git 状态 ≈ 合计 2494 token(比当前多 2311)
当前 level=1,全文约 183 token该会话原文 87 MB,level=1 为 183 token。
Related MCP server: eywa-mcp
阶梯
层 | 内容 | 成本(99 轮会话实测) |
1 | 最后一条结论 + 该轮提问 | 183 token |
2 | 最近 3 轮(提问 + 结论) | 551 token |
3 | 每轮需求 + 结论 | 4130 token |
4 | 改动文件 / 命令 / git 状态 | 2494 token(前 40 个文件、最近 15 条命令) |
| 指定切片: | 由切片决定 |
每层是独立视角,不是叠加:报价是该视角全文的成本,与当前停在哪一层无关。第 3 层随轮数线性增长, 长会话中可能高于第 4 层,按报价选择。
最后一轮没有结论时(中断、仍在运行、末条为进展说明),第 1 层会明确标注,并附最近一条有结论的 轮次及其轮号与成本。
设计取舍
不整份读取。 只取用户提问、最终 assistant 文本、工具调用目标与 git 状态;思考块、工具输出、
base_instructions跳过。四层作答,够用即停。 每层附下一层的 token 成本。
已知信息由调用方传入(
--known/known),不依赖推测。
安装
给 agent 的安装方式(推荐)
把本仓库地址直接贴给任意编码 agent,让它按这一节执行:
读 https://github.com/tianemon/ai-agent-bridge 的「安装」一节:把 aab 注册成你所在客户端的 MCP server, 然后跑
aab doctor验证。
agent 会自己完成:
npx -y @tianemon/ai-agent-bridge install— aab 自动写已适配的客户端(EasyMint、DeepSeek Harness 全部 profile、WorkBuddy、Codex、Claude Code)aab doctor— 看「能装」一节,确认自己所在的客户端是否已注册没适配自己的工具 → 自己把 stdio MCP 写进本工具的配置目录(agent 知道自己是哪个工具):
command = <node 绝对路径>,args = ["<aab 安装路径>/bin/aab.mjs", "mcp"],然后重启它
aab prompt 打印同一份指令(中英跟随系统语言),可直接粘给 agent。
手动安装
install 只写本机确实存在的客户端配置,写入前备份,可重复执行。能自动写的宿主:EasyMint、DeepSeek
Harness(全部 profile)、WorkBuddy、Codex、Claude Code。
npx -y @tianemon/ai-agent-bridge install --dry-run # 只打印要写什么
npx -y @tianemon/ai-agent-bridge install --agent codex,claude # 限定客户端
npx -y @tianemon/ai-agent-bridge install easymint # 只写 EasyMint(等价 --agent easymint)
aab prompt # 打印可交给 agent 执行的指令不安装也可以直接运行 node <repo>/bin/aab.mjs <命令>。
从源码使用时先打包再安装,不使用符号链接:
npm pack && npm i -g ./tianemon-ai-agent-bridge-<版本>.tgz
aab install # 让各家配置指向新路径aab doctor 的 mode 行显示当前运行形态:npm 全局安装 / 开发目录 / npx 缓存。
客户端没被适配怎么办
任何支持 MCP 的客户端都能用 aab,只是写配置这一步得自己来。确认本机的 aab 安装路径:
aab doctor # script 一行就是 aab.mjs 的绝对路径然后在该客户端的 MCP 设置里加一条 stdio server:
{
"aab": {
"command": "<node 绝对路径>",
"args": ["<aab 安装路径>/bin/aab.mjs", "mcp"]
}
}DSH 这类按 profile 分目录的客户端,把配置写进对应 profile 的用户覆写层(DSH 是每个
~/.dsh/profiles/<name>/cordis.patch.yml)。
作为 MCP server
服务形态是 aab mcp(stdio)。install 会写入配置;以下是手写形式,用于自行配置或客户端尚未覆盖的情况。
终端宿主(Claude Code、Codex CLI)可用短命令
aab mcp;GUI 宿主(WorkBuddy、Codex Desktop) 启动子进程时PATH可能被裁剪,需给绝对路径。
WorkBuddy — ~/.workbuddy/mcp.json
{
"mcpServers": {
"aab": {
"command": "/opt/homebrew/bin/node",
"args": ["/Users/you/dev/ai-agent-bridge/bin/aab.mjs", "mcp"]
}
}
}Codex — ~/.codex/config.toml
[mcp_servers.aab]
command = "/opt/homebrew/bin/node"
args = ["/Users/you/dev/ai-agent-bridge/bin/aab.mjs", "mcp"]
startup_timeout_sec = 20Claude Code
claude mcp add --scope user aab /opt/homebrew/bin/node /Users/you/dev/ai-agent-bridge/bin/aab.mjs mcpEasyMint — <EASYMINT_HOME>/agent/mcp.json(默认 ~/.easymint/agent/mcp.json;旧位置 ~/.easymint/mcp.json 里还有条目时沿用旧文件,不另建新文件)
{
"mcpServers": {
"aab": {
"type": "stdio",
"command": "/opt/homebrew/bin/node",
"args": ["/Users/you/dev/ai-agent-bridge/bin/aab.mjs", "mcp"],
"description": "读取其它 AI 编码工具的会话"
}
}
}DeepSeek Harness — 每个 profile 的用户覆写层 ~/.dsh/profiles/<name>/cordis.patch.yml(desktop / web / tui 各一份,追加一项)
- insert:
- name: '@deepseek-ai/dsh-mcp-client'
id: aab
config:
serverName: aab
transport: stdio
command: "/opt/homebrew/bin/node"
args:
- "/Users/you/dev/ai-agent-bridge/bin/aab.mjs"
- mcp改完重启桌面版(profile 在进程启动时读取)。
工具:session_latest、session_list、session_read、session_grep、session_agents。
WorkBuddy 需要手动确认一次
WorkBuddy 不会提示新的 MCP server,且在确认前不加载。aab install 写入后需确认一次:
连接器 → 自定义连接器 → aab → 信任
Connectors → Custom connectors → aab → Trustaab doctor 显示当前状态:
WorkBuddy ✓ 已注册 · ✓ 已信任(2026-10-24 12:26)
WorkBuddy ✓ 已注册 · ✗ 未信任 → 连接器 → 自定义连接器 → aab → 信任
WorkBuddy ✓ 已注册 · ⚠ 信任记录对应的是旧配置,需重新确认授权记录由 WorkBuddy 签发,工具不代写。若不需要 WorkBuddy 接入,有两种方式:
aab install --agent codex,claude,不写入 WorkBuddy走 CLI 而非 MCP:在项目的
CLAUDE.md/AGENTS.md中写明需要其他工具会话时执行aab latest
作为 CLI
aab list --since 24h # 时间、工具、项目、id、体积、标题
aab latest --agent codex --level 1 # 最新结论
aab latest --agent codex --level 3 # 更高一层
aab latest --turns 40-41 # 精确区间
aab latest --turns last:5 # 最近 5 轮
aab latest --turns from:60 # 第 60 轮至末尾
aab latest --turns "around:40±2" # 第 40 轮前后窗口(默认跨度 3)
aab latest --known '{"agent":"codex","session":"01a16729","turns":"last:3"}'
aab read --session 53bf411c --level 2
aab grep "paths-ignore" --agent claude --limit 3 # 命中带会话 id 与轮次号
aab rule # 打印可粘进 CLAUDE.md / AGENTS.md 的常驻规则grep 的命中标注「第 N 轮」,可直接 aab read --session <id> --turns N 取上下文。达到条数上限时提示
用 --agent / --since 缩小范围,扫描顺序为最近活动优先。
标题
列表与表头都带标题。标题来源:
工具 | 来源 | 改名后 |
Codex |
| 该文件追加写入:每次改名多一行,取 |
WorkBuddy / CodeBuddy | 应用 SQLite 的 |
|
Claude Code / EasyMint | 无标题存储,取该会话第一个真实提问 | 不适用 |
兜底标题压成一行并跳过纯图片消息,因此首条为图片的会话没有标题(id 仍可用)。
--known 接受 JSON(工具、项目、会话、轮次区间、时间窗)。显式参数优先于 known 中同名字段;
MCP 侧对应 known 与 maxChars。
输出语言:AAB_LANG=zh|en,否则跟随 LC_ALL / LANG(默认英文)。会话正文不翻译,只换标签。
常驻规则:aab rule
MCP 的 InitializeResult.instructions 在规范中是可选项,宿主可以不注入。WorkBuddy 实测不注入,
模型只能看到工具名(且为 deferred,需先检索)。因此工具描述只能提高命中概率,宿主每个会话都会读的
文件才能保证生效。
aab rule # 打印片段;正文走 stdout,写入哪个文件的提示走 stderr粘进项目根的 CLAUDE.md(WorkBuddy / Claude Code)或 AGENTS.md(Codex)。内容为说法与调用的对照
(「查看 codex 会话」「接着继续做」)以及不要手工解析 rollout-*.jsonl。该步骤可选。
作用域
默认本项目:工作目录归到 git 根。--scope 调整:
scope | 行为 |
| 本项目优先;找不到时退到全机,并在输出中注明 |
| 仅本项目,不回退,找不到报错 |
| 全机 |
支持的工具
工具 | 会话位置 | 环境变量 |
Codex |
|
|
Claude Code |
|
|
WorkBuddy |
|
|
CodeBuddy |
|
|
EasyMint |
|
|
DeepSeek Harness |
|
|
WorkBuddy 与 CodeBuddy 使用同一套写入器(transcript 含 __codebuddyLocal 字段),由一个适配器覆盖:
type:"message" 配 input_text / output_text 块,function_call / function_call_result /
reasoning / file-history-snapshot 行跳过。WorkBuddy 将用户提问包在 <system-reminder> 信封中,
实际文本位于 <user_query> 内。
DeepSeek Harness 的会话是多帧 zstd(每次追加一个 frame,单条会话实测 69 帧),需逐帧解压;同一会话
目录下可能同时存在旧版 session.jsonl.zstd;只取版本号最高的那个,两个都读会把轮次算成两份。索引取
storages/session_projcache/sessions/<id>.json(明文 JSON),不必解压即可拿到 cwd / 标题 / 模型。
子代理 trace(subagents/*.jsonl、agent-*.jsonl)排除在外,它们是模型内部的委派过程,不是与用户的
对话。
适配细节:Codex 按 session_meta.session_id 将多个 rollout 文件归为一个 thread(续跑会新写文件);
Claude Code 一文件一会话;伪装成用户消息的压缩摘要(isCompactSummary)单独隔离。
新增工具
新建 src/agents/<名字>.mjs:
export default {
name: "cursor",
label: "Cursor",
root: () => "/path/to/cursor/data",
index(project) {
// → [{ id, cwd, model, files: [{ file, mtimeMs, size }] }]
},
async parse(files) {
// → { turns: [{ i, user, userTs, finals: [], narration: [], tools: [], files: [] }], compaction: [] }
},
userTurnOf(o) {}, // 一行是否开启新一轮:返回用户原文或 ""
userMarker: '"role":"user"', // 廉价字面预筛:含它才值得 JSON.parse
};然后在 src/registry.mjs 的 LIST 中登记一行。
限制
会话数据只读。 不写任何工具的数据目录;唯一写入的是 MCP 配置(
install,可预览)。 外部进程仅git log/git status/git rev-parse,固定参数,不经 shell。单个会话可达数十 MB(本机实测 87 MB),分层读取,不会整份进入上下文。
Windows 未实测。目录 slug 的兜底逻辑假设 POSIX 路径;主判据是从文件读取
cwd,只影响头部缺cwd的会话。不提供会话浏览界面与全文检索,只做分级读取。
用户提问逐字读取。在上一个工具中输入的任何内容(含密钥)都会出现在新上下文中。
仅中英两种输出语言。标签全部走
src/i18n.mjs字典,英文模式下若有一条命令输出中文,测试会失败; 增加语言只需补字典条目。WorkBuddy 的信任确认无法自动化,
aab doctor只报告状态。DeepSeek Harness 依赖 Node ≥ 22.15 内置的 zstd;更低版本会跳过这类会话,
aab doctor会写明原因。
维护
发版与安装规则见 docs/RELEASING.md,要点见 AGENTS.md。
生产环境运行的是发布产物,不是本仓库源码。
许可
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Sync coding-agent sessions and resume them in any other agent: Claude Code, Codex, Cursor, more.
Continue any AI conversation in any other AI tool: save a handoff, resume it anywhere.
Hand off work between AI agents in any tool. Start Devin or Cursor cloud and share memory.
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to query and analyze past Claude Code sessions, providing structured insights like file changes, decisions, errors, and git history across projects.111MIT
- AlicenseAqualityDmaintenanceProvides cross-session memory for Claude Code by extracting structured handoffs at session end and retrieving relevant past context at session start.27MIT
- AlicenseNot gradedqualityCmaintenanceEnables cross-tool session reading and bidirectional incremental context synchronization for AI coding tools such as Codex, Claude Code, and VS Code Copilot, with exact caller identification and incremental transcript access.6 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to retrieve a bounded context packet linking relevant code with prior session evidence, decisions, failures, and fixes from local Codex and Claude Code history.Apache 2.0