From af99254ca49c6bebe881d7f8c4a5ed0f479125fe Mon Sep 17 00:00:00 2001
From: ekroon <123574+ekroon@users.noreply.github.com>
Date: Wed, 7 Jan 2026 11:39:18 +0100
Subject: [PATCH] Enhance troubleshooting documentation

Add troubleshooting tips for clipboard tools and TMUX over SSH.
---
 packages/web/src/content/docs/troubleshooting.mdx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/web/src/content/docs/troubleshooting.mdx b/packages/web/src/content/docs/troubleshooting.mdx
index 6c857b7e3f2..d460c0d1e1b 100644
--- a/packages/web/src/content/docs/troubleshooting.mdx
+++ b/packages/web/src/content/docs/troubleshooting.mdx
@@ -163,3 +163,11 @@ export DISPLAY=:99.0
 ```
 
 opencode will detect if you're using Wayland and prefer `wl-clipboard`, otherwise it will try to find clipboard tools in order of: `xclip` and `xsel`.
+
+**For TMUX over SSH (3.3+):**
+
+Add to your `~/.tmux.conf` or `~/.config/tmux/tmux.conf`:
+
+```bash
+set -g allow-passthrough on
+```