hermes - 💡(How to fix) Fix [TUI Bug] Chinese text rendering: character scattering and ghosting [3 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#17603Fetched 2026-04-30 06:46:25
View on GitHub
Comments
3
Participants
2
Timeline
7
Reactions
0
Author
Participants
Timeline (top)
labeled ×4commented ×3
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.

Screenshots

Screenshot 1 Screenshot 2

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 in the TUI rendering engine to account for full-width Chinese characters may resolve the rendering issue.

Guidance

  • Verify that the TUI rendering engine is correctly handling full-width characters by checking its documentation or source code for character width calculation logic.
  • Test the hermes --tui command with other full-width character sets, such as Japanese or Korean text, to see if the issue is specific to Chinese characters.
  • Consider using a different terminal or environment to isolate if the issue is specific to WSL2 or Windows Terminal.
  • Review the screenshots provided to ensure that the issue is not related to font or encoding settings.

Example

No code snippet is provided as the issue seems to be related to the internal logic of the hermes command and its TUI rendering engine.

Notes

The issue may be specific to the combination of WSL2, Windows Terminal, and the hermes command. Further investigation is needed to determine the root cause and develop a comprehensive solution.

Recommendation

Apply workaround: Adjust the character width calculation in the TUI rendering engine or use a different terminal/environment until a fixed version of hermes is available, as the issue seems to be related to the internal logic of the command.

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 Bug] Chinese text rendering: character scattering and ghosting [3 comments, 2 participants]