From a58f6689268858a7ba0386ef1811e3235aa64921 Mon Sep 17 00:00:00 2001 From: Andrew White Date: Tue, 28 Jul 2026 14:39:44 -0500 Subject: [PATCH 1/2] fix(core): reuse bracket_ipv6 in format_gateway_url and document IPv6 forwarding Addresses gator-agent review feedback on #2449: - Consolidate IPv6 bracketing by having format_gateway_url() call bracket_ipv6(). - Add an IPv6 loopback example to the Port Forwarding docs section showing the bracketed http://[::1]:8000/ URL. Signed-off-by: Andrew White --- docs/sandboxes/manage-sandboxes.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/sandboxes/manage-sandboxes.mdx b/docs/sandboxes/manage-sandboxes.mdx index e520c55f4..66a166864 100644 --- a/docs/sandboxes/manage-sandboxes.mdx +++ b/docs/sandboxes/manage-sandboxes.mdx @@ -361,6 +361,13 @@ openshell forward start 8000 my-sandbox -d # run in background OpenShell prints the local URL only after the forward listener is reachable. Background forwards must be tracked locally so `openshell forward list` and `openshell forward stop` can manage them. +To bind the local side to an IPv6 loopback address, use `-b`/`--bind-addr`. IPv6 addresses are bracketed in both the SSH forward argument and the printed access URL: + +```shell +openshell forward start 8000 my-sandbox -b ::1 +# Local URL: http://[::1]:8000/ +``` + List and stop active forwards: ```shell From f684685195de861ed1d48544ada4acd5fbb54e2c Mon Sep 17 00:00:00 2001 From: Andrew White Date: Wed, 29 Jul 2026 19:27:14 -0500 Subject: [PATCH 2/2] docs(sandboxes): use positional [bind_address:]port in IPv6 forward example `openshell forward start` has no -b/--bind-addr option; the bind address is passed positionally as [bind_address:]port. Update the prose and command so the example parses (openshell forward start ::1:8000 my-sandbox). Signed-off-by: Andrew White --- docs/sandboxes/manage-sandboxes.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sandboxes/manage-sandboxes.mdx b/docs/sandboxes/manage-sandboxes.mdx index 66a166864..c9d29a58d 100644 --- a/docs/sandboxes/manage-sandboxes.mdx +++ b/docs/sandboxes/manage-sandboxes.mdx @@ -361,10 +361,10 @@ openshell forward start 8000 my-sandbox -d # run in background OpenShell prints the local URL only after the forward listener is reachable. Background forwards must be tracked locally so `openshell forward list` and `openshell forward stop` can manage them. -To bind the local side to an IPv6 loopback address, use `-b`/`--bind-addr`. IPv6 addresses are bracketed in both the SSH forward argument and the printed access URL: +To bind the local side to an IPv6 loopback address, pass it positionally as `[bind_address:]port`. IPv6 addresses are bracketed in both the SSH forward argument and the printed access URL: ```shell -openshell forward start 8000 my-sandbox -b ::1 +openshell forward start ::1:8000 my-sandbox # Local URL: http://[::1]:8000/ ```