From f0dc8d00f2210b1e2de05bad3e008202814fac2c Mon Sep 17 00:00:00 2001
From: Egor Merkushev <gorkaedeep@gmail.com>
Date: Thu, 2 Jul 2026 17:52:44 +0300
Subject: [PATCH] Document broker stop after upgrades

---
 README.md                                                  | 7 +++++++
 .../XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md  | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 6df40d7..000f611 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,13 @@ claude mcp add --transport stdio xcode -- uvx --from mcpbridge-wrapper mcpbridge
 codex mcp add xcode -- uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker
 ```
 
+After upgrading, stop the old singleton daemon once so the next `--broker` client
+starts the new package version:
+
+```bash
+uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker-stop
+```
+
 For full start/stop/status commands, Cursor JSON snippets, troubleshooting, and
 rollback to direct mode, see [Broker Mode Guide](docs/broker-mode.md).
 
diff --git a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
index 6e53d15..c9c5031 100644
--- a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
+++ b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
@@ -127,6 +127,13 @@ claude mcp add --transport stdio xcode -- uvx --from mcpbridge-wrapper mcpbridge
 codex mcp add xcode -- uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker
 ```
 
+After upgrading, stop the old singleton daemon once so the next `--broker` client
+starts the new package version:
+
+```bash
+uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker-stop
+```
+
 For troubleshooting and rollback details, see <doc:CursorSetup>,
 <doc:ClaudeCodeSetup>, <doc:CodexCLISetup>, and <doc:Troubleshooting>.