tui: WSL image paste fails with X11 clipboard errors after upgrading to V2 #58466

Activity

1. opencode-agent commented on Oct 23, 2026

   

   opencode-agentBot

   on Oct 23, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed diagnostics! I think this is a duplicate of #49895, which tracks clipboard image paste failing on WSL2 with Windows Terminal in OpenCode v2 (it worked in 1.x).

   Possible duplicates and related issues, ordered from most to least likely:

   • tui: image paste fails silently on WSL when no clipboard tool is installed (V2) #49895: image paste from the Windows clipboard fails on WSL2 in v2. PR fix(tui): read clipboard images through Windows interop on WSL #57470 proposes a fix: when the native clipboard read fails on WSL, read the Windows clipboard through powershell.exe (as 1.x did) and show an error instead of failing.
   • tui: image clipboard paste silently ignored on WSL2 Debian (regression 1.3.x → 2.1.2) #57724: the same regression (WSL2, 2.1.2, worked in 1.3.x), already closed as a duplicate of tui: image paste fails silently on WSL when no clipboard tool is installed (V2) #49895.
   • tui: image paste fails on WSL2/WSLg with libwayland-client 1.18 — Wayland clipboard backend is rejected, X11 fallback can't serve images #55639: shows the same kind of "X11 clipboard ..." error on WSLg. When the Wayland clipboard isn't used, the TUI falls back to X11, and WSLg's X11 bridge only serves text, so image requests are refused. You've ruled out its libwayland cause, but the X11 part is likely what you're seeing.

   Until a fix lands, these workarounds from #49895 may help:

   • Run export WAYLAND_DISPLAY=/mnt/wslg/runtime-dir/wayland-0 before starting opencode, so the Wayland clipboard is found even if XDG_RUNTIME_DIR doesn't point to WSLg's runtime dir.
   • Update WSL with wsl --update. Newer WSLg versions fixed image paste for some people.

   The bot will close this issue as a duplicate in 1 day unless you reply explaining how your problem is different.
2. opencode-agent

   added

   pending close

   triaging

   on Oct 23, 2026
3. Gabb1995 commented on Oct 23, 2026

   

   Gabb1995

   on Oct 23, 2026

   Author

   More actions

   Confirmed: launching with the suggested absolute Wayland socket path restores clipboard image paste:

   WAYLAND_DISPLAY=/mnt/wslg/runtime-dir/wayland-0 opencode

   On this affected environment, /mnt/wslg/runtime-dir/wayland-0 exists and is a socket, while /run/user/1000/wayland-0 does not exist. Before the workaround, XDG_RUNTIME_DIR=/run/user/1000/ and WAYLAND_DISPLAY=wayland-0.

   The user tested the command and confirmed image paste works. No WSL update or clipboard package installation was required. This is Ubuntu 24.04.2 LTS with OpenCode 2.1.3; libwayland-client.so.0 loads and exports wl_proxy_marshal_array_flags.

   Thanks for the workaround! Happy for this to be tracked under #49895.
4. Gabb1995

   closed this as completedon Oct 23, 2026
5. opencode-agent

   closed this as duplicateon Oct 24, 2026
6. opencode-agent commented on Oct 24, 2026

   

   opencode-agentBot

   on Oct 24, 2026 – with OpenCode Agent

   Contributor

   More actions

   We haven't heard back, so I'm closing this as a duplicate of #49895. That issue tracks clipboard image paste failing on WSL2 with Windows Terminal in OpenCode v2, and PR #57470 proposes a fix: read the Windows clipboard through powershell.exe when the native clipboard read fails on WSL. Please follow #49895 for updates.

   Until the fix lands, two workarounds from that thread may help:

   • Run export WAYLAND_DISPLAY=/mnt/wslg/runtime-dir/wayland-0 before starting opencode, so it uses the Wayland clipboard instead of falling back to X11.
   • Update WSL with wsl --update.

   If your problem turns out to be different, reply here and we can reopen.
7. simonklee

   added a commit that references this issue on Oct 29, 2026

   native: reconnect the X11 clipboard after a connection failure (#1844)

   ...

   0718aa9