From af097376b8afdc5d304889ef92d64b77e45267f7 Mon Sep 17 00:00:00 2001
From: devlooped-bot <bot@devlooped.com>
Date: Wed, 22 Jul 2026 04:40:25 +0000
Subject: [PATCH] =?UTF-8?q?+M=E1=90=81=20includes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/go/readme.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/go/readme.md b/src/go/readme.md
index 96f38a9..89794e9 100644
--- a/src/go/readme.md
+++ b/src/go/readme.md
@@ -62,6 +62,29 @@ dnx go
 dnx go -- app.cs
 dnx go -- kzu/sandbox
 ```
+
+### Open local files and remote refs
+
+Use `open` to shell-open a local file in the default app, or open the web URL for a
+remote ref in the browser — without downloading or running the app:
+
+```console
+# Open a local file (editor / OS association)
+dnx go -- open app.cs
+
+# Open the GitHub/GitLab/gist web page for a remote ref
+dnx go -- open kzu/sandbox
+dnx go -- open kzu/sandbox@main:src/hello.cs
+dnx go -- open gist.github.com/kzu/0ac826dc7de666546aaedd38e5965381
+
+# Interactive: pick from MRU history, then open the selection
+dnx go -- open
+```
+
+With no input, `open` uses the same history list as the default command (searchable
+picker). Empty history or a non-interactive terminal fails with a clear error instead
+of hanging. Opening does not record a new history entry.
+
 Native AOT needs a platform C/C++ linker (VC++ build tools on Windows, `build-essential` on
 Ubuntu, Xcode Command Line Tools on macOS). Verify with: