[Bug]: Installs from homebrew / linuxbrew cannot run TUI

[travisgroth]

Bug Description

Looks like #19514 isn't actually resolved.

Installed on ubuntu via homebrew. Running 0.18.0. When launching with --tui, it still fails to start:

% hermes --version
Hermes Agent v0.18.0 (2026.7.1)
Project: /home/linuxbrew/.linuxbrew/Cellar/hermes-agent/2026.7.1/libexec/lib/python3.14/site-packages
Python: 3.14.6
OpenAI SDK: 2.24.0
Up to date

% hermes --tui
Error: the TUI workspace is missing from this Hermes checkout.
Expected directory: /home/linuxbrew/.linuxbrew/Cellar/hermes-agent/2026.7.1/libexec/lib/python3.14/site-packages/ui-tui
This usually means `hermes update` left tracked ui-tui files deleted.
Recovery:
  1. From the Hermes checkout, run `git restore -- ui-tui`
  2. Run `npm install --silent --no-fund --no-audit --progress=false`
  3. Retry `hermes --tui`
If the checkout is still inconsistent, run `hermes update --force`.

Steps to Reproduce

1. Install hermes via homebrew brew install hermes-agent
2. Start hermes with hermes --tui

Expected Behavior

Hermes starts successfully in TUI mode.

Actual Behavior

Error about missing tui workspace:

Error: the TUI workspace is missing from this Hermes checkout.
Expected directory: /home/linuxbrew/.linuxbrew/Cellar/hermes-agent/2026.7.1/libexec/lib/python3.14/site-packages/ui-tui
This usually means `hermes update` left tracked ui-tui files deleted.
Recovery:
  1. From the Hermes checkout, run `git restore -- ui-tui`
  2. Run `npm install --silent --no-fund --no-audit --progress=false`
  3. Retry `hermes --tui`
If the checkout is still inconsistent, run `hermes update --force`.

Affected Component

CLI (interactive chat)

Messaging Platform (if gateway-related)

No response

Debug Report

n/a

Operating System

Ubuntu 26.04 LTS

Python Version

3.14.6

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

• I'd like to fix this myself and submit a PR