From 48ebd5a1ff12c768965e1a9b31e25db7254b76af Mon Sep 17 00:00:00 2001
From: pdmarf <135653545+pdmarf@users.noreply.github.com>
Date: Fri, 17 Apr 2026 17:19:06 +0100
Subject: [PATCH] docs: add uninstall/reinstall instructions and WHICHVM note

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md  | 20 ++++++++++++++++++++
 WHICHVM.md |  3 +++
 2 files changed, 23 insertions(+)
 create mode 100644 WHICHVM.md

diff --git a/README.md b/README.md
index 1871336..591207f 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,26 @@ Stream Deck will open and install the plugin automatically.
 
 ---
 
+## Uninstall & Reinstall
+
+If the plugin is not updating or behaving unexpectedly, do a clean reinstall:
+
+1. Remove the plugin folder:
+```bash
+rm -rf ~/Library/Application\ Support/com.elgato.StreamDeck/Plugins/com.pdma.notion-timer.sdPlugin
+```
+
+2. Quit and relaunch Stream Deck.
+
+3. Reinstall the latest version:
+```bash
+curl -sL https://gitea.pdmarf.co.uk/pdm/stream_deck_notion_timer/raw/branch/master/notion-timer.streamDeckPlugin -o /tmp/notion-timer.streamDeckPlugin && open /tmp/notion-timer.streamDeckPlugin
+```
+
+Stream Deck will install the plugin and auto-updates will work from that point on.
+
+---
+
 ## Auto-Updates
 
 Updates are automatic — no action needed from staff.
diff --git a/WHICHVM.md b/WHICHVM.md
new file mode 100644
index 0000000..f7b48d2
--- /dev/null
+++ b/WHICHVM.md
@@ -0,0 +1,3 @@
+# Which VM
+
+The context for this project's development conversation is on the Mac.