Agent 通信架构：邮箱模式为何优于实时消息注入

一款面向 Codex worktree 的非打扰式邮箱伴侣

由 Adem Isler 开发 · 采用 MIT 许可证 · 提供 macOS 和 Linux 开发版本

CodexPigeon 允许用户为 Codex 任务留下仓库本地的指导信息，同时不会将消息注入当前活跃的聊天轮次。

它会为每个选定的 repo/worktree 创建一个 .codex-mailbox/ 文件夹。应用和 CLI 会把用户消息追加到 INBOX.md；Codex Agent 则通过已安装的项目指令和 hooks，在安全的检查点读取这些消息，然后将状态写回由 Agent 管理的文件。

这款产品遵循一组严格的不变量：

不干预活跃聊天

不注入聊天消息

不使用轮次中断或轮次启动 API

不使用 App Server 写入 API

应用不会写入由 Agent 管理的 OUTBOX.md 或 RECEIPTS.md

这个仓库的设计目标是便于检查。邮箱协议采用纯 Markdown，运行时文件存放在 repo 本地，所有 Codex App Server 访问都被限制为读取、状态查询和发现方法。

当前版本已经可以正常运行……