From 34327520b6d18345c663c43bd4698ab4a5e82f0c Mon Sep 17 00:00:00 2001
From: Marcus <marcusvebo@gmail.com>
Date: Mon, 22 Jun 2026 16:52:50 +0200
Subject: [PATCH] docs: Windows deploy order (quit before install) to avoid
 pywin32 lock

---
 CLAUDE.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index c34e726..906c53b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -22,10 +22,19 @@ containers, images, compose files, networks, and system housekeeping.
 
 ```
 1. Claude Code commits and pushes
-2. uv tool install --reinstall git+<repo-url>
-3. Restart Claude Desktop (tray icon → Quit → relaunch)
+2. Fully quit Claude Desktop (tray icon → Quit) so the running MCP server
+   releases its file locks
+3. uv tool install --reinstall git+<repo-url>
+4. Relaunch Claude Desktop
 ```
 
+**Windows lock gotcha — quit BEFORE install:** on Windows the running MCP
+server holds `pywin32` files open, so `uv tool install --reinstall` fails
+mid-swap (`os error 32: used by another process`) and leaves the tool env
+incomplete (the old packages are already uninstalled). The order above
+(quit → install → relaunch) avoids this — never reinstall while Claude Desktop
+is still running.
+
 **Push retry:** the Gitea remote (`gitea.gecheckt.de`) occasionally
 returns `Unauthorized` on the first push attempt. If `git push` fails
 with an auth error, wait 1 s and retry once before reporting back.