flatbread-cli 0.2.0 → 0.3.0

package/README.md

@@ -158,8 +158,15 @@ It runs after the commit exists, so no SHA changes. When the repository sets `co
 set machine-wide (system or global config), the hook goes in the repository's own hooks
 directory and setup says it fires only if that machine-wide hook runs it.
 
-`setup --dry-run` writes nothing. `setup --uninstall` removes the handlers and the hook, and puts
-a chained hook back byte for byte. `FLATBREAD_HOOK_DISABLED=1` stops every capture.
+Setup also registers the MCP server at Claude Code's user scope (`mcpServers.flatbread` in
+`~/.claude.json`, or `$CLAUDE_CONFIG_DIR/.claude.json`), so every project has it and none asks you
+to approve a `.mcp.json`. Only that one entry is touched: a file that is not JSON is refused, a
+server named `flatbread` that runs something else is left alone, the file's BOM, line endings and
+mode are kept, and the first write leaves `~/.claude.json.flatbread.bak`. Restart Claude Code (or
+reload the VS Code window) afterwards. `--no-mcp` skips it.
+
+`setup --dry-run` writes nothing. `setup --uninstall` removes the handlers, the MCP entry and the
+hook, and puts a chained hook back byte for byte. `FLATBREAD_HOOK_DISABLED=1` stops every capture.
 
 `flatbread search <words>` answers from this machine's shared runs, its captured runs, then the
 site - the same text the MCP tool returns. Words are matched as typed, and by stem ("retry" finds
@@ -167,8 +174,14 @@ site - the same text the MCP tool returns. Words are matched as typed, and by st
 exits 1.
 
 `pull` and `mcp` only read. A token from `flatbread login` goes only to the site that issued it;
-a private run's share link (`?t=`) is sent as a header, never in a URL. Add the MCP server to
-Claude Code with `claude mcp add flatbread -- flatbread mcp`.
+a private run's share link (`?t=`) is sent as a header, never in a URL. `pull <id>` reads a run
+this machine shared or captured from disk, so it works offline; anything else comes from the site.
+Without `setup`, add the MCP server by hand: `claude mcp add --scope user flatbread -- flatbread mcp`.
+
+`share` writes the reviewed draft to `last-share.json`, which the next share replaces. The run is
+not lost with it: every share is also kept under its own ID, which `search --local` lists and
+`pull <id>` prints. The review page listens on 127.0.0.1, on 4321-4325, or a port the OS picks
+when all five are busy.
 
 ### Building the package
 

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,31 @@
+# Third-party notices
+
+## deja-vu
+
+`src/adapters/antigravity.ts` reads conversations the way deja-vu reads Windsurf trajectories
+(`internal/sources/windsurf.go`), and `test/fixtures/antigravity/*.pb` are its fixtures
+(`fixtures/registry/windsurf/cascade/`).
+
+```
+MIT License
+
+Copyright (c) 2026 Vladislav Shulcz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```