Skip to content

TUI transparency not working in WSL2 + WezTerm #21397

Closed as not planned
Closed as not planned

Description

@Franciscojg1

Description

Descripción:
### Pre-flight Checks

 - [x] I have searched existing issues and this is not a duplicate                                                                                                                                                                        
 - [x] I understand this issue needs status:approved before a PR can be opened
                                                                                                                                                                                                                                          
 ### Bug Description                                                                                                                                                                                                                      
 The TUI background is not transparent when running OpenCode in WSL2 with WezTerm on Windows, even when using the `system` theme or a custom theme with `"background": "none"`.

 Other TUI apps respect WezTerm's transparency, but OpenCode shows a solid black/opaque background.

 ### Steps to Reproduce
 1. Configure WezTerm with `window_background_opacity = 0.85` and `text_background_opacity = 0.85`
 2. Run OpenCode in WSL2
 3. Observe that the background is opaque instead of transparent

 ### Expected Behavior
 OpenCode should respect terminal transparency like other TUI apps (vim, nano, etc.)

 ### Actual Behavior
 OpenCode displays a solid black background that blocks the terminal's transparent background

 ### Operating System
 - Windows 11 (host)
 - WSL2 Ubuntu (guest)

 ### Agent / Client
 OpenCode 1.3.17

 ### Shell
 bash

 ### Configuration

 WezTerm config (.wezterm.lua):
 ```lua
 config.window_background_opacity = 0.85
 config.text_background_opacity = 0.85

 OpenCode config (opencode.json):

 {                                                                                                                                                                                                                                   ▄
   "theme": "system"  // also tried custom transparent theme                                                                                                                                                                         █
 }                                                                                                                                                                                                                                   █
                                                                                                                                                                                                                                     █
 Additional Context                                                                                                                                                                                                                  █
 - Tested with theme: "system" - doesn't work                                                                                                                                                                                        █
 - Tested with custom theme setting all backgrounds to "none" - doesn't work                                                                                                                                                         ▀
 - Other TUI apps (vim, htop, etc.) correctly show transparency

Plugins

No response

OpenCode version

1.3.17

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

Windows 11

Terminal

Wezterm

Activity

  1. added
    opentuiThis relates to changes in v1.0, now that opencode uses opentui
    on Apr 7, 2026
  2. github-actions commented on Apr 7, 2026

    @github-actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    If your issue is specifically about WSL2 + WezTerm not being covered by the fix in #8467, please clarify that in the issue so maintainers can assess whether a new fix is needed.

  3. Franciscojg1 commented on Apr 9, 2026

    @Franciscojg1
    Author

    Hellp

  4. removed
    bugSomething isn't working
    opentuiThis relates to changes in v1.0, now that opencode uses opentui
    on May 3, 2026
  5. github-actions commented on Jul 6, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions