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 分

    請在儲存庫或註冊中心條目中宣告授權條款。