diff --git a/home-manager/progs/opencode.nix b/home-manager/progs/opencode.nix
index 919a41d..5590d64 100644
--- a/home-manager/progs/opencode.nix
+++ b/home-manager/progs/opencode.nix
@@ -195,6 +195,8 @@ in
       small_model = "openrouter/openai/gpt-oss-20b:free";
 
       autoshare = false;
+      # note: this updates opencode (and plugins like oh-my-opencode) at launch,
+      # bypassing the version pinned in flake.lock
       autoupdate = true;
       agent = { };
       plugin = [ "oh-my-opencode" ];