From 75dfa0e9a741c1051a7b9eb3b1fc9dd181b60fb1 Mon Sep 17 00:00:00 2001
From: Michael Granitzer <michael.granitzer@uni-passau.de>
Date: Sat, 3 Jan 2026 09:22:36 +0100
Subject: [PATCH] docs: add query command --local/--remote specifier variation

---
 docs/branch/py4lexis4-cmd.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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
-- 
2.51.2