postbag

Name: postbag
Author: parasxos

本地服务

github.com/parasxosAI 与智能体114 周前更新

代码仓库

关于 postbag

postbag 是供同一台机器上的 Claude Code 与 Codex 会话互发消息的本地 MCP 服务，适合需要交叉审查或拆分工作的开发者。它通过会话原生输入把消息交给对方，并为每个对话袋保留本地记录。

主要功能

01会话间发送消息
02按名称加入对话袋
03分页读取对话记录
04查看本地对话袋与成员
05退出对话袋并保留记录

适用场景

01让 Codex 审查 Claude Code 的改动
02由不同 Agent 分担实现与测试
03向另一会话征求问题分析

MCP 相关

postbag 提供五个 MCP 工具，用于加入、发送和读取对话袋，以及列出对话袋或退出。接收方会话通过自身输入收到新一轮消息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "parasxos-postbag": {
      "command": "uvx",
      "args": [
        "postbag"
      ],
      "env": {
        "POSTBAG_CODEX": "<POSTBAG_CODEX>"
      }
    }
  }
}

启动命令uvx postbag

需要配置的环境变量

POSTBAG_CODEXPath to the codex executable for Codex delivery when several are installed.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypipostbag2.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
bag	string	否	默认收件袋或指定名称的收件袋。加入时会创建不存在的收件袋。
name	string	是

详细介绍

postbag

让 Codex 和 Claude Code 互相交流。

一个本地 MCP 服务。让 Codex 审查 Claude Code 刚写好的内容，或者反过来。回复会作为新一轮对话送达。无需在窗口之间复制文本。

一段真实录制并经过剪辑和加速的运行过程。Codex 加入 bag review。Claude Code 加入后请 Codex 审查上次提交，请求以第 1 封信的形式送达 Codex。Codex 阅读差异、运行测试，发现有一个失败任务被报告为 None，并将两项发现作为最终信件发回。Claude Code 对照差异检查后表示同意。

安装

需要 Python 3.10 或更高版本、Claude Code，以及带有 codex queue 的近期版本 Codex CLI。请在同一台机器上使用相同版本的 postbag 运行两个会话。投递功能已在 macOS 上测试。

pipx install 'postbag[mcp]'
claude mcp add --scope user postbag -- "$(command -v postbag-mcp)"
codex mcp add postbag -- "$(command -v postbag-mcp)"

在每个应用中启动新会话，然后运行 /mcp。postbag 应列出五个工具。如需 uvx 和其他配置方式，请参阅 MCP 配置。

或者询问你的 Agent：使用 llms-install.md 安装 postbag。

快速开始

一个 bag 是一段有名称的对话。两个 Agent 加入同一个 bag。在同一个仓库中打开 Codex 和 Claude Code，让双方都能看到相同的代码。

在 Codex 中：

加入 postbag bag "review"，身份为 codex。
在 Claude Code 中：

加入 postbag bag "review"，身份为 claude，然后请 codex 审查我上次的提交。

先让 Codex 加入，这样 Claude Code 才有人可以发送消息。出现提示时，请批准 postbag 工具。Codex 会在新一轮对话中收到请求，其回复也会以同样的方式送达 Claude Code。任一方都可以用一封最终信件结束对话，这表示无需回复。

适用场景

交叉审查。 Claude Code 完成更改后，请 Codex 在提交前审查差异。
拆分工作。 Codex 编写测试，同时由 Claude Code 编写实现。双方通过信件交流进展。
征求第二意见。 一个 Agent 遇到难以解决的 bug 时，可以请另一个 Agent 重新审视。

工具

你的 Agent 会调用这些工具。你只需用普通语言提出请求。

工具	功能
`postbag_join`	在一个 bag 中以指定名称注册此会话；如果 bag 不存在，则创建它。
`postbag_send`	向 bag 中某个名称发送信件。`final: true` 表示无需回复。
`postbag_read`	分页浏览 bag 的历史记录。
`postbag_bags`	列出本地 bag、信件数量和已注册名称。
`postbag_leave`	将此会话从 bag 中移除。历史记录会保留。