关于 flatbread
Flatbread 是用于将编码 Agent 会话分享为链接的命令行工具和本地审核流程。内容上传前会在本机隐藏密钥与个人信息;人员或 Agent 可读取已分享运行记录并据此继续工作。
主要功能
- 01读取多种编码 Agent 的会话
- 02分享前在本地审核运行记录
- 03上传前隐藏密钥与个人信息
- 04设置私密、不公开或公开访问
- 05让 Agent 获取并延续已分享的运行记录
适用场景
- 01分享编码 Agent 运行记录供他人审核
- 02让其他 Agent 根据先前运行结果继续工作
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 5 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 否 | 任务或错误中的两到四个词。标题或 ID 中包含所有这些词的运行记录优先;如果没有完全匹配的记录,则列出最接近的结果,并标明共有多少个词 |
| harness | enum | 否 | 仅搜索此 Agent 框架中的运行记录claude-code | codex | cursor | opencode | antigravity | gemini | cline | copilot | terminal | otel |
详细介绍
Flatbread
Flatbread 将一次 Agent 会话变成一个链接:包含提出的问题、每个步骤、出错之处、解决方法和差异。人们可以阅读,Agent 可以获取内容并从会话结束处继续。
这个软件包名为 flatbread-cli。切勿运行 npx flatbread 或 npm install flatbread:这个 npm 名称属于另一个无关项目。
分享你的首次运行
- 安装:
npm install -g flatbread-cli。你需要 Node.js 20 或更高版本(nodejs.org)。 - 连接你的 Agent,只需一次:
flatbread setup。之后就可以直接在聊天中分享。更新会让它保持最新状态;之后安装的 Agent 也会在 Flatbread 下次运行时自动连接,因此无需再次运行此命令。 - 会话结束后,在聊天中说
share this run,或在终端中运行flatbread share。在终端中运行时,它会显示所选的会话。不是你想要的会话?它会列出其他工具最近一次会话对应的命令,例如flatbread share gemini。 - 浏览器中会打开审核页面。它在你自己的计算机上运行(
127.0.0.1),此时还没有任何内容离开你的计算机。没看到标签页?打开终端或 Agent 显示的链接。 - 检查内容。密钥、密码和个人信息已经隐藏。你也可以隐藏更多文字,并选择谁可以打开会话:Private(仅你)、Unlisted(任何拥有链接的人)或 Public(公开)。
- 点击 Confirm & share。还没有登录?先点击 Sign in to Flatbread:系统会打开新标签页,并保留你在此页面上的选择。
- 复制链接:随后打开的页面会显示链接,并提供 Copy link。
想让 Agent 帮你完成第 1 和第 2 步?告诉它:使用 https://flatbread.io/install.md 安装并设置 Flatbread
任何人的 Agent 都可以说“pull flatbread ”来阅读该会话的经验。
Flatbread 可以读取 Claude Code、Codex、Cursor、OpenCode、Google Antigravity、Gemini CLI、Cline 和 GitHub Copilot CLI 的会话。flatbread setup 会连接 Claude Code、Codex、Cursor、Google Antigravity、OpenCode、Gemini CLI、GitHub Copilot CLI 和 Cline。
此存储库中的内容
文档、更新日志和问题表单。CLI 已作为 flatbread-cli 发布到 npm;其源代码未在此处发布。
- install.md - Agent 设置 Flatbread 时遵循的步骤
- docs/commands.md - 所有命令
- docs/redaction.md - 上传内容之前会在你的计算机上删除哪些信息
- CHANGELOG.md - npm 上各版本的变更内容
- SECURITY.md - 如何报告漏洞,或 Flatbread 漏掉的机密信息
问题反馈适用于 Bug、遗漏的脱敏项,以及你希望 Flatbread 读取的 Agent。网站:https://flatbread.io
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。