Flatbread

io.github.flatbread-cli由 GitHub 账号 flatbread-cli 发布v0.9.8更新于 Nov 1, 2026

Share a coding agent's session as one link, secrets redacted first; pull another run's brief.

概览

AI 生成的概览

Flatbread 把 AI 编程代理的会话记录成可分享的链接(默认先脱敏),并让助手搜索其他运行记录、读取其执行简报。

可以做什么
  • 搜索已记录的编程代理运行,包括自己账号的和 flatbread.io 上的公开运行,找出做过类似任务的记录
  • 获取某次运行的执行简报:需求、人工干预、遇到的阻碍与解决办法、测试结果和代码差异
  • 把当前会话分享为一次 Flatbread 运行,先打开默认脱敏的审阅页面
  • 选择谁能打开分享的运行:私有、不公开列出或公开
适用场景
适合在开始任务前让助手确认是否已有人做过同样的事或遇到同样的报错,复用其他运行的改动思路与注意事项,或把已完成的会话发布成一个可审阅的链接。
运行要求
以 npm 包 flatbread-cli 通过 stdio 在本机运行,需要 Node.js 20 或更高版本。需先执行一次 flatbread setup 连接受支持的代理,确认并分享运行时还需登录 Flatbread 账号。包名是 flatbread-cli,npm 上的 flatbread 属于无关项目。
安装前请注意
在本地审阅页面确认后,会话内容会上传到 Flatbread;密钥默认会被隐藏,但仍应检查页面并补充隐藏内容。选择不公开列出或公开后,任何拿到链接的人都能查看。搜索范围包括 flatbread.io 上的公开运行以及自己账号下的运行。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Flatbread,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Flatbread

Flatbread turns an agent session into one link: what was asked, every step, what broke, what fixed it and the diff. People read it. Agents pull it and pick up where it ended.

The package is flatbread-cli. Never run npx flatbread or npm install flatbread: that npm name belongs to an unrelated project.

Share your first run

  1. Install it: npm install -g flatbread-cli. You need Node.js 20 or newer (nodejs.org).
  2. Connect your agents, once: flatbread setup. Then you can share from their chat. Updates keep it current, and an agent you install later is connected the next time Flatbread runs, so you never run it again.
  3. When a session is done, say share this run in its chat, or run flatbread share in a terminal. From a terminal it says which session it took. Not the session you meant? It prints the command for every other tool's newest, such as flatbread share gemini.
  4. A review page opens in your browser. It runs on your own computer (127.0.0.1), and nothing has left it yet. No tab? Open the link the terminal or your agent printed.
  5. Check it. Keys, passwords and personal details are already hidden. Hide more words if you like, and choose who can open the run: Private (only you), Unlisted (anyone with the link) or Public.
  6. Press Confirm & share. Not signed in yet? Press Sign in to Flatbread first: it opens a new tab, and this page keeps what you chose.
  7. Copy your link: the page that follows shows it, with Copy link.

Rather have your agent do steps 1 and 2? Tell it: Install and set up Flatbread using https://flatbread.io/install.md

Anyone's agent can then say "pull flatbread " to read what that run learned.

Flatbread reads sessions from Claude Code, Codex, Cursor, OpenCode, Google Antigravity, Gemini CLI, Cline and GitHub Copilot CLI. flatbread setup connects Claude Code, Codex, Cursor, Google Antigravity, OpenCode, Gemini CLI, GitHub Copilot CLI and Cline.

In this repository

The docs, the changelog and the issue forms. The CLI is published on npm as flatbread-cli; its source is not published here.

Issues are for bugs, missed redactions and agents you want Flatbread to read. Site: https://flatbread.io

来源:README.md,提交 3637ca6

工具

3

flatbread_search_traces

Search Flatbread runs

Search recorded AI coding-agent runs (your own Flatbread account's, and public runs on flatbread.io) for one that already did a similar task. Use it BEFORE starting a task that someone may have solved before, or after hitting an error, to find a run that hit the same wall. Returns run IDs; pass one to flatbread_get_brief for what that run learned.

输入参数queryharness

flatbread_get_brief

Get a run's execution brief

Fetch the execution brief of one Flatbread run: what was asked, how the human steered it, each blocker and the fix (so you do not repeat it), what the tests said, and the diff. Every quote is the run's own text. Pass a run ID from flatbread_search_traces, or a flatbread.io/r/<id> link.

输入参数slug必填

flatbread_share

Share this run

Share the session you are in now as a Flatbread run. Call it when the user says "share this run", "flatbread share", "share to flatbread" or anything like it. It finds this session, leaves the share request out, opens a review page with every secret redacted by default, and returns its link at once - give the user that link: it is uploaded when the user presses Confirm there, which shares it to their Flatbread account. That press is the user's to make, never yours. Always pass cwd and suggested_title. For only part of a long session ("share from prompt 4 to 8"), pass from and to_prompt.

输入参数cwdfromharnessto_promptredact_termssuggested_title

版本历史

1
  1. v0.9.8最新Oct 31, 2026

评分

已满足适用检查项的 80%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。