本地工作日志
在回合进行期间记录受支持的工具输入和结果，包括超时或空结果等有用的失败信息。
AI 编码代理的本地记忆
Eggshell 是面向 AI 编码代理的本地记忆工具，以 Codex CLI 为核心。它会记录一次聊天中的工作，例如代码库搜索、命令、文档发现、工具结果和结论，并将相关历史提供给同一项目中的另一个聊天。其目的是在代理对话结束或开始后续任务时，减少重复调查的需要。
Codex 集成会将项目记忆存储在本地 Eggshell 文件中，并使用本地搜索和图处理来组织这些记忆。后续代理会收到经过选择的交接内容，并被要求复用有依据的发现、核查可能已发生变化的事实，以及说明哪些内容已复用或尚未验证。该项目还包含 Claude Code、Gemini CLI、Cursor 和 OpenCode 的独立实验性适配器，但这些集成的构建和安装过程与已发布的 Codex 插件彼此独立。
核心功能
相关历史记录检索
使用本地文本匹配和 MiniLM 嵌入，在项目配置允许 Eggshell 读取的文件中查找相关工作。
跨聊天交接
在图中关联请求、操作和结果，然后将选定的既往工作作为上下文发送给新聊天。
增量持久化
独立保存每条观察记录，并重试中断的写入；未完成的工作会保持开放，而已完成的回合会添加父级结果。
本地组织
在本地运行搜索和图处理，不使用 LLM 来总结记忆、分类记忆或维护图。
显式工作流控制
提供 `!egg doctor`、`!egg graph`、`!egg keep` 和 `!egg drop` 等 Codex 控制命令，用于检查设置、查看交付内容、保存回合或清除当前回合。
实际使用场景
继续代码库调查
在代码库调查期间记录命令、搜索和源代码发现，然后让新聊天基于已记录的证据继续工作，而不是重复最初的探索。
后续实现工作
保存已完成的实现或调试回合的结果，并将相关决策和支持性操作传递给同一项目中的后续任务。
检查交接来源
使用 `!egg graph` 检查哪些既往工作实际已交付给代理，帮助在继续之前确认交接内容包含预期上下文。
恢复中断的会话
在会话中断后保留未完成的工作；排队的写入会自动重试，下一项任务可以区分历史结果和需要重新核查的事实。
测试其他编码代理
在使用 Claude Code、Gemini CLI、Cursor 或 OpenCode 时安装相应的独立适配器，同时将这些集成视为实验性方案，而不是与文档化 Codex 工作流等同的方案。
Pros and Cons
Pros
- 在本地完成记忆组织和检索，无需调用 LLM 进行摘要或图维护。
- 保留中间工具证据和未完成的工作，而不只是保存最终摘要。
- 支持项目级跨聊天交接，让后续任务能够基于早期调查继续进行。
- 提供用于检查交付内容和管理当前回合的显式控制命令。
Cons
- 主要的文档化集成需要 Codex CLI 插件和命令钩子；普通 ChatGPT Chat 不提供自动记忆。
- Claude Code、Gemini CLI、Cursor 和 OpenCode 适配器属于实验性的源代码构建集成，其实时会话 token 节省效果尚未评估。
- 选定的记忆内容以及代理后续的工作仍会消耗模型正常的输入和输出 token。
FAQ
Eggshell 支持哪些平台和前置条件？
Eggshell 面向 macOS 或 Linux 上的 Codex CLI 项目，支持 Apple Silicon/ARM64 或 x86-64。Codex 客户端必须支持插件和命令钩子。
如何安装和验证 Eggshell？
使用文档中的安装程序或从源代码检出安装 Codex 插件，然后在项目中运行 `egg init`。在 Codex 中通过 `/hooks` 查看并启用 Eggshell 的钩子，启动新聊天，并使用 `!egg doctor` 检查设置。
记忆如何在聊天之间传递？
初始化后，Eggshell 会在本地记录受支持的工具结果和最终答案，搜索相关的历史工作，并将选定的历史记录作为交接内容发送给后续聊天。普通任务不需要特殊提示词，不过可以使用 `!egg keep` 明确保存已完成的回合。
Eggshell 可以与其他 AI 编码客户端一起使用吗？
Codex 集成使用命令钩子，因此普通 ChatGPT Chat 不提供自动的 Eggshell 记忆。Claude Code、Gemini CLI、Cursor 和 OpenCode 的适配器是独立的实验性源代码构建集成。
Eggshell 会消除模型 token 的使用吗？
Eggshell 的搜索和图处理在本地运行，不会为了摘要、分类或图维护调用 LLM。检索到的记忆以及代理后续的工作仍会使用模型正常的输入和输出 token。
Quick Facts
- 类别
- 开发者工具
- 主要客户端
- Codex CLI
- 部署模式
- 本地项目记忆与处理
- 主要支持平台
- macOS 和 Linux；Apple Silicon/ARM64 或 x86-64
- 项目源代码
- github.com/momonpya/eggshell
- 其他集成
- 适用于 Claude Code、Gemini CLI、Cursor 和 OpenCode 的实验性适配器
Eggshell 替代品
ByteAsk
ByteAsk 是面向 C 和 C++ 的终端优先 AI 编码 agent，可直接编辑仓库，并在展示 diff 前用真实编译器、调试器、sanitizers 和测试验证修改。提供免费版与付费方案。
Goldfish
Goldfish 是一款适用于 macOS 的 AI 记忆应用，可帮你在 Mac 上基于现有上下文进行回复、写作、总结并继续创作。支持本地存储记忆，保留你的写作语气。
Lasso
Lasso 是一站式电商产品数据平台，用于丰富目录记录、处理供应商文件、生成产品内容并监控竞品，提供 Web 应用、REST API、SDK 和 MCP server，适合团队与开发者。
CreateOS Sandbox
CreateOS Sandbox 是基于 Firecracker 微型虚拟机的隔离计算环境，用于运行代码和 agent 工作负载，支持私有网络、SDK、CLI 和 MCP 程序化控制。
ArtDeck
ArtDeck 是一款适用于 iPhone、iPad 和 Mac 的视觉参考板应用，可将多种参考素材收纳到同一画布，并用 ToolBox 镜片进行观察；支持离线使用、可选 iCloud 同步，且一次购买，无需账号。
GitBot
GitBot 是基于本地浏览器的工作区，可借助 Claude Code、Codex 或 OpenCode 创建可复用的编程机器人，跨仓库文件夹运行代理，并保留持久线程与可配置权限。