From 2c82e6c6ae2cd7472de3598c2bf3bb2a4e9560d2 Mon Sep 17 00:00:00 2001
From: Filip <34747899+neriousy@users.noreply.github.com>
Date: Sun, 1 Feb 2026 17:52:43 +0100
Subject: docs: prefer wsl over native windows stuff (#11637)

---
 packages/web/src/content/docs/web.mdx | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'packages/web/src/content/docs/web.mdx')

diff --git a/packages/web/src/content/docs/web.mdx b/packages/web/src/content/docs/web.mdx
index fa3d07109..1013712f3 100644
--- a/packages/web/src/content/docs/web.mdx
+++ b/packages/web/src/content/docs/web.mdx
@@ -21,6 +21,10 @@ This starts a local server on `127.0.0.1` with a random available port and autom
 If `OPENCODE_SERVER_PASSWORD` is not set, the server will be unsecured. This is fine for local use but should be set for network access.
 :::
 
+:::tip[Windows Users]
+For the best experience, run `opencode web` from [WSL](/docs/windows-wsl) rather than PowerShell. This ensures proper file system access and terminal integration.
+:::
+
 ---
 
 ## Configuration
-- 
cgit v1.2.3

