Quick symptom table
Display
Colors look wrong in tmux
Colors look wrong in tmux
Add a true-color terminal type to Reload tmux with:Restart Herm after changing tmux configuration.
~/.tmux.conf:Text is hard to read
Text is hard to read
Open
/theme and choose a light or high-contrast theme such as daylight, mercury, github, or warm-lightmode.Display looks garbled
Display looks garbled
Press
Ctrl+L. Herm clears its render baseline and repaints the full UI. This does not interrupt the active session.Images and eikons
Inline images are not displaying
Inline images are not displaying
Herm renders inline images through Install it with your package manager:chafa is optional. Herm still works without inline image rendering.
chafa. Check whether it is installed:Eikon rendering fails
Eikon rendering fails
Eikon Studio media decoding needs
ffmpeg. The native rasterizer avoids chafa, but it still depends on ffmpeg for media decoding.Install ffmpeg, restart Herm, then reopen Studio.Gateway startup
Gateway will not start or Herm cannot find Hermes
Gateway will not start or Herm cannot find Hermes
Herm starts the Hermes Agent gateway as a subprocess. If startup fails, run Use
/logs when the UI is visible.Common overrides:/status to confirm the resolved Herm version, gateway model, and paths.API keys are not picked up after editing .env
API keys are not picked up after editing .env
Run
/reload after editing ~/.hermes/.env or the active profile .env file.MCP servers or skills look stale
MCP servers or skills look stale
Use the reload command for the stale surface.
Session control
Cannot interrupt a running agent
Cannot interrupt a running agent
Double-tap
Esc. A single Esc press only moves focus or shows an interrupt notice. The second press sends the interrupt.Composer loses focus
Composer loses focus
Double-tap
Tab to return focus to the composer from any non-Chat tab. A single Tab cycles focus within the current tab.Session state seems stale
Session state seems stale
Press
r in session lists to refresh visible rows. Use /reload only for environment changes and /reload-mcp only for MCP/tool changes.Windows
Python cannot be found on Windows
Python cannot be found on Windows
Set Then restart Herm.
HERMES_PYTHON to the Python executable that has Hermes Agent dependencies available.