#3501·waveterm

[Bug]: Broken/cascading TUI rendering layout on Windows (PowerShell/CMD)

Author: szogun1910Created Sep 9, 2026Updated Sep 9, 2026
Labelsbugtriage

Current Behavior

Describe the Bug

When running full-screen terminal user interfaces (TUI) built with Node.js (like Freebuff, which uses blessed or ink under the hood) on Windows using a local PowerShell or CMD profile, the interface layout renders incorrectly. The text lines and border boxes break and cascade incrementally to the right side of the screen instead of aligning properly.

To Reproduce

  1. Open Wave Terminal on Windows (Windows 11 / Windows 10).
  2. Use a local profile (PowerShell or Command Prompt).
  3. Run a TUI application (e.g., npx freebuff or any advanced interactive Node.js CLI tool).
  4. Observe the shifted, cascading render layout.

Expected Behavior

The text interface and box borders should render properly aligned to the left edge of the terminal window, maintaining a correct fixed grid width (e.g., 80 columns), just like it does in native Windows Terminal or classic CMD.

Screenshots

(PLEASE PASTE YOUR SCREENSHOT HERE)

Additional Context

  • OS: Windows
  • Shell: PowerShell / CMD
  • Wave Terminal Version: Latest
  • Attempted Fixes (did not work):
    • Setting term:fontfamily to "Consolas" in settings.json
    • Forcing "term:localshell": "cmd" and "term:localshellpath"
    • Setting environment variables prior to launch: $env:TERM="xterm-256color", set COLUMNS=80, set LINES=24
    • Resizing the terminal window or using Ctrl + L (the block formatting remains permanently broken).

Expected Behavior

The text interface and box borders should render properly aligned to the left edge of the terminal window, maintaining a correct fixed grid width, just like it does in native Windows Terminal or classic CMD.

Steps To Reproduce

Image

Wave Version

v0.14.5

Platform

Windows

OS Version/Distribution

No response

Architecture

arm64

Anything else?

No response