From 59e72d62add81a5866f94976ae4e651afb8edbb7 Mon Sep 17 00:00:00 2001
From: ori <oribarilan@gmail.com>
Date: Sun, 31 May 2026 22:09:43 +0300
Subject: [PATCH] docs: explain why install uses a versioned ref

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 578fd53..0ec4b86 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,9 @@ Add to your `tui.json` (or `.opencode/tui.json`):
 }
 ```
 
-To upgrade, change the version tag and restart OpenCode. You'll see a toast when a newer version is available.
+> **Why a versioned ref?** OpenCode resolves `@latest` once and caches it forever. Bumping the version in your config is the only reliable way to get updates.
+
+You'll see a toast when a newer version is available (can be turned off).
 
 ## Configuration