Share coding agent sessions as single links with automatic secret redaction and allow other agents to pull session history.
Also known as flatbread-cli/flatbread, flatbread-cli
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.9.8
- Last commit
- Nov 9, 2026
- License
- —
What is Flatbread MCP?
Flatbread is an MCP server. Share coding agent sessions as single links with automatic secret redaction and allow other agents to pull session history.
Summary generated from the project's README
About Flatbread MCP server
Flatbread allows developers to convert coding agent sessions into shareable links that include the full history of prompts, steps, errors, fixes, and diffs. It works by connecting to various coding tools such as Claude Code, Cursor, Codex, Cline, GitHub Copilot CLI, Gemini CLI, OpenCode, and Google Antigravity. Users install the tool via the flatbread-cli package using Node.js 20 or newer and run a setup command to link their agents.
Before any data leaves your machine, the local review page automatically redacts keys, passwords, and personal details. You can manually hide additional words and select a privacy level of Private, Unlisted, or Public before confirming the upload. Once shared, other agents can use the pull flatbread command followed by a specific ID to ingest the session history and continue the work where the previous session ended.
What you can do with it
- 1Share session history with humansA developer can provide a single link to a teammate so they can read exactly what was asked and how a problem was fixed.
- 2Transfer context between AI agentsYou can instruct a different agent to ingest the knowledge from a completed run to resume a task.
- 3Securely export coding logsYou can share session details while ensuring sensitive information like passwords and API keys are removed locally first.
Written from the project's README. Every use case is checked against a quote from it.
How to install Flatbread MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Flatbread MCP in Claude Code
$ claude mcp add flatbread -- npx -y flatbread-cliInstall Flatbread MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"flatbread": {
"command": "npx",
"args": [
"-y",
"flatbread-cli"
]
}
}
}Install Flatbread MCP in VS Code
.vscode/mcp.json
{
"servers": {
"flatbread": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"flatbread-cli"
]
}
}
}Install Flatbread MCP in VS Code CLI
$ code --add-mcp '{"name":"flatbread","type":"stdio","command":"npx","args":["-y","flatbread-cli"]}'Install Flatbread MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"flatbread": {
"command": "npx",
"args": [
"-y",
"flatbread-cli"
]
}
}
}Install Flatbread MCP in Codex
$ codex mcp add flatbread -- npx -y flatbread-cliInstall Flatbread MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.flatbread] command = "npx" args = ["-y", "flatbread-cli"]
Install Flatbread MCP in Gemini CLI
$ gemini mcp add -s user flatbread npx -- -y flatbread-cliInstall Flatbread MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"flatbread": {
"command": "npx",
"args": [
"-y",
"flatbread-cli"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableflatbread-cli/flatbread is public and reachablegithub.com/flatbread-cli/flatbread ↗Pass
- Package names this repository as its sourceflatbread-cli names flatbread-cli/flatbread as sourcenpmjs.com/package/flatbread-cli ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-09github.com/flatbread-cli/flatbread ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from flatbread-cliPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFlatbread
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
- Install it:
npm install -g flatbread-cli. You need Node.js 20 or newer (nodejs.org). - 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. - When a session is done, say
share this runin its chat, or runflatbread sharein 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 asflatbread share gemini. - 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. - 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.
- 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.
- 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.
- install.md - the steps an agent follows to set Flatbread up
- docs/commands.md - every command
- docs/redaction.md - what is removed on your machine before anything uploads
- CHANGELOG.md - what changed in each version on npm
- SECURITY.md - how to report a vulnerability, or a secret Flatbread missed
Issues are for bugs, missed redactions and agents you want Flatbread to read. Site: https://flatbread.io
Flatbread MCP questions
How do I add Flatbread MCP to Claude Code?
Run claude mcp add flatbread -- npx -y flatbread-cli in your terminal. Add --scope user to make it available in every project.
How do I add Flatbread MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I share a session?
You can say 'share this run' in your agent's chat or run 'flatbread share' in your terminal.
Is my sensitive data safe when sharing?
Yes, keys, passwords, and personal details are automatically hidden before anything is uploaded.
Which coding agents are supported?
Flatbread supports Claude Code, Codex, Cursor, OpenCode, Google Antigravity, Gemini CLI, Cline, and GitHub Copilot CLI.
Can other agents use the shared data?
Yes, any agent can read the learnings from a run by using the command 'pull flatbread <id>'.