How to fix the garbled character misalignment of Hermes Agent TUI?

If the Hermes Agent TUI is garbled, overladen, or misaligned, first check the terminal compatibility: confirm that it is a true TTY, that the Node.js version is new enough, and that the terminal size is normal, and then temporarily turn off mouse tracking. Recently, Ubuntu users in the community have reported that TUI content overwrites each other, and this kind of problem is usually not a model problem, but an unstable terminal rendering layer.

Do a minimum investigation first

1. Run hermes doctor to confirm that the Node.js meets at least the TUI requirements.
2. Switch to a terminal test, such as System Terminal, iTerm2, Windows Terminal, or VS Code Integrated Terminal.
3. Expand the window and re-enter the hermes --tui to avoid narrow windows triggering layout squeezing.
4. If the mouse selects text incorrectly, change display.mouse_tracking to false in the configuration.

When to go back to the classic CLI

If you repeatedly misplace in remote SSH, old terminals, and tmux nested environments, continue working with normal hermes first. TUI and classic CLI share sessions and configurations, and don't lose history just because you switch back to classic. After the terminal environment is stable, use hermes --tui -c to continue the recent session.