hermes - 💡(How to fix) Fix TUI rendering glitch: Chinese text causes character scattering and ghosting [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#17602Fetched 2026-04-30 06:46:28
View on GitHub
Comments
2
Participants
2
Timeline
7
Reactions
0
Author
Participants
Timeline (top)
labeled ×4commented ×2cross-referenced ×1
RAW_BUFFERClick to expand / collapse

Bug Description

When using hermes --tui, the terminal UI rendering breaks with Chinese text output. Characters scatter to the right side of the screen, leaving ghost trails and overlapping text.

Steps to Reproduce

  1. Run hermes --tui
  2. Engage in a conversation that produces Chinese text output (several paragraphs)
  3. Observe — text does not wrap correctly, characters appear scattered on the right side

Expected Behavior

Chinese text should render cleanly without ghosting or scattering.

Actual Behavior

  • Characters scatter on the right side of the screen
  • Large irregular whitespace mid-sentence
  • Characters overlap vertically (ghost effect)
  • Status bar shows duplicated fragments
  • Text lines broken mid-sentence

Environment

  • OS: WSL2
  • Terminal: Windows Terminal / browser-based terminal

Possible Cause

CJK character width calculation issue. Chinese characters are full-width (2 cells) but the TUI rendering engine calculates them as 1 cell, causing incorrect line-wrap and cursor position misalignment.

extent analysis

TL;DR

Adjusting the character width calculation to account for full-width Chinese characters may resolve the terminal UI rendering issue.

Guidance

  • Verify that the TUI rendering engine is correctly configured to handle full-width characters, potentially by checking the character width calculation logic.
  • Investigate if there are any existing options or settings in hermes --tui to adjust character width handling for CJK characters.
  • Consider testing with a different terminal emulator to isolate if the issue is specific to Windows Terminal or browser-based terminals.
  • Review the code responsible for rendering Chinese text to ensure it correctly accounts for the full-width nature of these characters.

Example

No specific code example can be provided without access to the hermes source code, but the fix would likely involve adjusting the character width calculation to treat Chinese characters as 2 cells wide instead of 1.

Notes

The solution may depend on the specific implementation details of the hermes --tui rendering engine and how it handles character widths. This guidance assumes that the issue is indeed related to the character width calculation as suggested in the possible cause.

Recommendation

Apply a workaround by adjusting the character width calculation or handling in the hermes --tui configuration or code, as upgrading to a fixed version is not mentioned as an option in the provided issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix TUI rendering glitch: Chinese text causes character scattering and ghosting [2 comments, 2 participants]