diff --git a/docs/branch/py4lexis4-cmd.md b/docs/branch/py4lexis4-cmd.md
index 388db53..784c3b4 100644
--- a/docs/branch/py4lexis4-cmd.md
+++ b/docs/branch/py4lexis4-cmd.md
@@ -250,6 +250,19 @@ owi remote ls lrz:latest          # Argument
 owi remote ls --spec lrz:latest   # Option (if needed for clarity)
 ```
 
+**Exception: Query Commands** use `--local` and `--remote` **options** because:
+- Can combine local AND remote in one query
+- Both are optional (at least one required)
+  
+```bash
+# Current query syntax (keep)
+owi query less --local . --remote main:latest select=url,title
+owi query less --remote all/id=f6ea5756-... limit=10
+
+# Proposed Typer
+owi query less --local . --remote main:latest --select url,title
+```
+
 ---
 
 ### Typer Migration: Parameter Strategy