# Hermes Terminal Dashboard

```
╔════════════════════════════════════════════════════════════════╗
║  1 0 1     0 1 0     1 1 0      0 0 1      1 0 1               ║
║                                                                ║
║   ███╗   ███╗  █████╗  ████████╗ ██████╗  ██╗ ██╗  ██╗         ║
║   ████╗ ████║ ██╔══██╗ ╚══██╔══╝ ██╔══██╗ ██║ ╚██╗██╔╝         ║
║   ██╔████╔██║ ███████║    ██║    ██████╔╝ ██║  ╚███╔╝          ║
║   ██║╚██╔╝██║ ██╔══██║    ██║    ██╔══██╗ ██║  ██╔██╗          ║
║   ██║ ╚═╝ ██║ ██║  ██║    ██║    ██║  ██║ ██║ ██╔╝ ██╗         ║
║                                                                ║
║              ██╗   ██╗ ██╗                                     ║
║              ██║   ██║ ██║      ACCESS_GRANTED                 ║
║              ██║   ██║ ██║      STATUS::ACTIVE                 ║
║              ╚██████╔╝ ██║      MATRIX_UI::READY               ║
║               ╚═════╝  ╚═╝                                     ║
║                                                                ║
║  [ booting interface ] [ neural display ] [ secure shell ]     ║
╚════════════════════════════════════════════════════════════════╝

  Hermes Terminal Dashboard · MatrixUI  v1.7.0
```

> Um plugin **MCP (Model Context Protocol)** que dá a um agente de IA (Hermes) a
> capacidade de **exibir informações visuais** em um monitor físico ligado a um
> dispositivo Linux em modo CLI/terminal — sem X11/Wayland (ex.: Orange Pi com
> Ubuntu Server).
>
> *An MCP plugin that lets an AI agent draw rich, structured content on a
> physical monitor attached to a headless Linux box (e.g. an Orange Pi running
> Ubuntu Server in pure TTY mode).*

---

## 🇧🇷 Português

### O que é

O projeto tem dois processos desacoplados que conversam por um **socket TCP local**
(asyncio), evitando problemas de concorrência e de permissão de arquivos:

```
 ┌──────────┐  stdio   ┌───────────────┐  TCP NDJSON   ┌────────────────┐  HDMI
 │  Hermes  │ ───────▶ │ mcp_server.py │ ────────────▶ │ tui_display.py │ ─────▶ Monitor TTY1
 │   (IA)   │          │ (ferramenta)  │ localhost:9999│   (Textual)    │
 └──────────┘          └───────────────┘               └────────────────┘
```

- **`tui_display.py`** — Interface visual (Textual + Rich) rodando em primeiro plano
  no monitor. Abre um servidor TCP interno (asyncio) na porta `9999` para receber
  comandos. Layout estilo *cyberpunk/hacker*: header com relógio e status, painel
  principal que renderiza **Markdown** (títulos, listas, tabelas, código) e uma barra
  lateral de log de atividades.
- **`mcp_server.py`** — Servidor MCP (SDK oficial `mcp`, transporte stdio). Expõe as
  ferramentas `atualizar_monitor` e `limpar_monitor` para a IA. Conecta no socket da
  TUI, envia o payload JSON e retorna sucesso/erro para o agente.

### Protocolo

Mensagens em **JSON delimitado por newline (NDJSON)** — uma linha por mensagem.
Dois formatos, ambos suportados:

```json
{"conteudo": "# Título\n- item", "log": "Atualizando...", "acao": "update"}
{"tipo": "previsao_tempo", "dados": {"local": "SP", "dias": [...]}, "log": "..."}
```

| Campo      | Descrição                                                          |
|------------|--------------------------------------------------------------------|
| `tipo`     | Renderizador a usar. Default `markdown`. Skills: ver tabela abaixo. |
| `conteudo` | Markdown a renderizar (usado quando `tipo` é `markdown`).           |
| `dados`    | Objeto estruturado, específico de cada skill (quando `tipo` != md). |
| `log`      | Linha adicionada ao log lateral (opcional).                        |
| `acao`     | `update` (default), `clear`, `set_welcome`, `reset_welcome`.       |

> **Compatibilidade:** sem o campo `tipo`, o comportamento é idêntico ao original
> (renderiza `conteudo` como Markdown).

### Skills disponíveis

Cada skill é uma ferramenta MCP dedicada que o agente Hermes pode invocar. Os dados
são fornecidos pelo agente (o MCP não acessa rede); a TUI apenas os desenha em estilo
ncurses.

| Ferramenta MCP            | `tipo`           | O que renderiza                                      |
|---------------------------|------------------|------------------------------------------------------|
| `exibir_previsao_tempo`   | `previsao_tempo` | Cards de previsão do tempo com arte ASCII (wttr.in)  |
| `exibir_tabela`           | `tabela`         | Tabela rica com bordas e cores                        |
| `exibir_grafico`          | `grafico`        | Gráfico de barras (plotext, com fallback unicode)     |
| `exibir_metricas`         | `metricas`       | Gauges/barras coloridas por limiar (CPU, RAM, KPIs)   |
| `exibir_alerta`           | `alerta`         | Banner com texto gigante (pyfiglet)                   |
| `exibir_qrcode`           | `qrcode`         | QR Code em ASCII                                      |
| `exibir_tarefas`          | `tarefas`        | Checklist com ✓/☐ e prioridades                       |
| `exibir_noticias`         | `noticias`       | Lista de notícias com título, resumo e categorias     |
| `exibir_jogos_futebol`    | `jogos_futebol`  | Partidas com placar, status ao vivo e destaques       |
| `atualizar_monitor`       | `markdown`       | Markdown livre (texto genérico)                       |
| `personalizar_boas_vindas`| `boas_vindas`    | Tela inicial: logo + cor + mensagem customizados       |
| `resetar_boas_vindas`     | —                | Restaura a tela de boas-vindas padrão com logo         |

Exemplos de payload para teste via `nc` (uma linha cada):

```bash
# Previsão do tempo
printf '{"tipo":"previsao_tempo","dados":{"local":"São Paulo","dias":[{"dia":"Hoje","condicao":"chuva","temp_max":24,"temp_min":17,"descricao":"Pancadas","umidade":80,"vento":"15 km/h"},{"dia":"Ter","condicao":"sol","temp_max":28,"temp_min":18,"descricao":"Ensolarado"}]}}\n' | nc 127.0.0.1 9999

# Tabela
printf '{"tipo":"tabela","dados":{"titulo":"Vendas","colunas":["Produto","Qtd"],"linhas":[["Café","12"],["Pão","30"]]}}\n' | nc 127.0.0.1 9999

# Gráfico de barras
printf '{"tipo":"grafico","dados":{"titulo":"Temp","unidade":"°C","series":[{"label":"Seg","valor":23},{"label":"Ter","valor":27},{"label":"Qua","valor":19}]}}\n' | nc 127.0.0.1 9999

# Métricas / gauges
printf '{"tipo":"metricas","dados":{"titulo":"Sistema","metricas":[{"label":"CPU","valor":42,"unidade":"%%"},{"label":"RAM","valor":6,"max":8,"unidade":"GB"},{"label":"Disco","valor":91,"unidade":"%%"}]}}\n' | nc 127.0.0.1 9999

# Alerta / banner
printf '{"tipo":"alerta","dados":{"texto":"BACKUP OK","nivel":"info","subtitulo":"concluído às 03:00"}}\n' | nc 127.0.0.1 9999

# QR Code
printf '{"tipo":"qrcode","dados":{"conteudo":"https://exemplo.com","legenda":"Aponte a câmera"}}\n' | nc 127.0.0.1 9999

# Tarefas
printf '{"tipo":"tarefas","dados":{"titulo":"Hoje","itens":[{"texto":"Comprar pão","feito":false,"prioridade":"alta"},{"texto":"Pagar conta","feito":true}]}}\n' | nc 127.0.0.1 9999

# Notícias
printf '{"tipo":"noticias","dados":{"titulo":"Últimas Notícias","fonte":"G1","itens":[{"titulo":"Selic mantida em 13,75%","resumo":"O Copom decidiu manter a taxa de juros.","categoria":"Economia","tempo":"há 30 min"},{"titulo":"Seleção convoca 26 jogadores","resumo":"Lista com surpresas no ataque.","categoria":"Esportes"}]}}\n' | nc 127.0.0.1 9999

# Jogos de futebol
printf '{"tipo":"jogos_futebol","dados":{"titulo":"Rodada 15 — Brasileirão","data":"13/06/2026","jogos":[{"time_casa":"Flamengo","time_fora":"Palmeiras","placar_casa":2,"placar_fora":1,"status":"encerrado","estadio":"Maracanã","destaque":"Gol de Gabriel 78'"'"'"},{"time_casa":"Corinthians","time_fora":"São Paulo","placar_casa":0,"placar_fora":0,"status":"ao_vivo"},{"time_casa":"Atlético-MG","time_fora":"Cruzeiro","status":"agendado","horario":"16:00"}]}}\n' | nc 127.0.0.1 9999
```

### Instalação

```bash
git clone <seu-repo> matrixui
cd matrixui

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### Rodando a TUI no monitor físico (TTY1)

#### Opção A — getty@tty1 + .bash_profile *(recomendada, testada em produção)*

A forma mais simples e confiável: getty faz login automático, e o `.bash_profile`
inicia a TUI. Use o script automatizado:

```bash
# Copie o repositório para a Orange Pi e execute:
sudo bash install.sh <SEU_USUARIO>
```

Se preferir fazer manualmente:

1. Configure o override do getty:

```bash
sudo systemctl edit getty@tty1
```

Adicione na seção `[Service]`:

```ini
[Service]
ExecStart=
ExecStart=-/sbin/agetty --autologin <SEU_USUARIO> --noclear %I $TERM
Restart=always
RestartSec=3
```

2. Adicione o bloco TTY1 ao `~/.bash_profile`:

```bash
if [ "$(tty)" = "/dev/tty1" ]; then
    cd ~/matrixui && source .venv/bin/activate && exec python tui_display.py
fi
```

3. Habilite e inicie:

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now getty@tty1
```

Ao rebootar, a TUI aparece automaticamente no monitor.

#### Opção B — systemd (hermes-tui.service) *(alternativa: sem login shell)*

Se você prefere que o systemd reclame o TTY1 diretamente (sem shell de login):

```bash
# Ajuste os caminhos/usuário dentro do arquivo e instale:
sudo cp hermes-tui.service /etc/systemd/system/hermes-tui.service
sudo systemctl daemon-reload
sudo systemctl disable getty@tty1   # evita conflito
sudo systemctl enable --now hermes-tui.service
```

O unit declara `Conflicts=getty@tty1.service` e assume o `/dev/tty1`, reiniciando
automaticamente se cair (`Restart=always`).

#### Opção C — `openvt` (sob demanda)

Inicia a TUI em um terminal virtual livre e troca para ele:

```bash
sudo openvt -c 1 -s -- python ~/matrixui/tui_display.py
```

#### Opção D — `tmux` (inspecionável)

```bash
tmux new-session -d -s hermes 'python ~/matrixui/tui_display.py'
tmux attach -t hermes   # para visualizar
```

### Configurando o Hermes para carregar o servidor MCP

Use o `config.example.json` como base. Copie o bloco `hermes-monitor` para dentro do
`mcpServers` do `config.json` do seu agente, ajustando o caminho absoluto:

```json
{
  "mcpServers": {
    "hermes-monitor": {
      "command": "python",
      "args": ["/home/<SEU_USUARIO>/matrixui/mcp_server.py"],
      "env": {
        "HERMES_TUI_HOST": "127.0.0.1",
        "HERMES_TUI_PORT": "9999"
      }
    }
  }
}
```

> Use o `python` do virtualenv (ex.: `/home/<SEU_USUARIO>/matrixui/.venv/bin/python`) para
> garantir que as dependências sejam encontradas.

### Testando

Com a TUI rodando, teste o socket manualmente (sem o MCP):

```bash
printf '{"conteudo":"# Olá\n- item 1\n- item 2","log":"teste manual"}\n' | nc 127.0.0.1 9999
printf '{"acao":"clear"}\n' | nc 127.0.0.1 9999
```

Teste a ferramenta MCP com o inspector oficial:

```bash
mcp dev mcp_server.py
# invoque atualizar_monitor(conteudo_markdown="# Teste", mensagem_log="oi")
```

### Solução de Problemas

#### getty@tty1 não sobe no boot

Se o serviço `getty@tty1` não inicializa automaticamente ao ligar a Orange Pi:

```bash
systemctl is-active getty@tty1   # verifica o status
```

Se estiver inativo, crie um override com autologin e restart automático:

```bash
sudo systemctl edit getty@tty1
```

Adicione ou descomente as linhas (editor abre a seção `[Service]`):

```ini
[Service]
ExecStart=
ExecStart=-/sbin/agetty --autologin orangepi --noclear %I $TERM
Restart=always
RestartSec=3
```

Depois salve e execute:

```bash
sudo systemctl daemon-reload
sudo systemctl start getty@tty1
systemctl status getty@tty1   # confirma que está ativo
```

#### TUI não aparece no monitor

Se a TUI não renderiza após reboot:

**Se você está usando Opção A (getty + .bash_profile):**

```bash
systemctl is-active getty@tty1   # confirma que getty está ativo
systemctl status getty@tty1      # mostra se há erros
journalctl -u getty@tty1 -n 30 --no-pager   # logs do getty
cat ~/.bash_profile | grep -A 3 'HERMES TUI LAUNCHER'   # verifica o bloco TTY1
python ~/matrixui/tui_display.py   # testa a TUI manualmente
```

**Se você está usando Opção B (hermes-tui.service):**

```bash
systemctl status hermes-tui.service   # status do serviço
journalctl -u hermes-tui.service -n 50 --no-pager   # últimos 50 logs
```

Causas comuns em ambos os casos:
- Virtualenv não criada ou dependências não instaladas → `pip install -r requirements.txt`.
- Python ou path incorreto no `.bash_profile` ou `.service` → edite e verifique os caminhos.
- Permissões de TTY → confirme que o usuário tem acesso a `/dev/tty1`.

#### Porta 9999 já em uso

Se receber erro `Address already in use` ao iniciar a TUI:

```bash
ss -tlnp | grep 9999   # identifica qual processo ocupa a porta
sudo lsof -i :9999     # alternativa (se lsof estiver instalado)
```

Para usar uma porta diferente, ajuste as variáveis de ambiente no
`/etc/systemd/system/hermes-tui.service` (campo `Environment`) e no `config.json` do Hermes:

```bash
sudo systemctl edit hermes-tui.service
# [Service]
# Environment=HERMES_TUI_PORT=9998
sudo systemctl daemon-reload && sudo systemctl restart hermes-tui.service
```

### Variáveis de ambiente

| Variável           | Default       | Descrição                  |
|--------------------|---------------|----------------------------|
| `HERMES_TUI_HOST`  | `127.0.0.1`   | Host do socket da TUI.      |
| `HERMES_TUI_PORT`  | `9999`        | Porta do socket da TUI.     |

### Atalhos da TUI

| Tecla | Ação            |
|-------|-----------------|
| `Q`   | Sair            |
| `C`   | Limpar o painel |

### Exemplos de uso

Cada skill foi desenhada para um caso de uso específico. Veja cenários práticos:

#### 1. Previsão do tempo
**Quando usar:** o usuário pede "mostre a previsão do tempo" ou você quer exibir
dados meteorológicos visualmente. A renderização em cards com arte ASCII é muito
mais legível que uma tabela.

```python
# O agente obtém dados de clima (via API ou integração) e envia:
{
  "tipo": "previsao_tempo",
  "dados": {
    "local": "São Paulo, SP",
    "dias": [
      {"dia": "Hoje", "condicao": "chuva", "temp_max": 24, "temp_min": 17,
       "descricao": "Pancadas", "umidade": 80, "vento": "15 km/h"},
      {"dia": "Amanhã", "condicao": "sol", "temp_max": 28, "temp_min": 20,
       "descricao": "Ensolarado"}
    ]
  }
}
```

#### 2. Tabela
**Quando usar:** dados estruturados em linhas/colunas (vendas, relatórios, inventário,
etc.). Superior à renderização Markdown porque `rich.Table` alinha perfeitamente e
colore as bordas.

```python
{
  "tipo": "tabela",
  "dados": {
    "titulo": "Vendas do mês",
    "colunas": ["Produto", "Qtd", "Preço", "Total"],
    "linhas": [
      ["Café", "120", "R$ 15", "R$ 1.800"],
      ["Pão", "450", "R$ 0,75", "R$ 337,50"]
    ]
  }
}
```

#### 3. Gráfico de barras
**Quando usar:** série temporal ou comparação de valores (temperatura por dia, vendas
por mês, retorno de investimento, etc.). `plotext` desenha barras profissionais; se
falhar, cai para unicode.

```python
{
  "tipo": "grafico",
  "dados": {
    "titulo": "Temperatura por dia",
    "unidade": "°C",
    "series": [
      {"label": "Seg", "valor": 23},
      {"label": "Ter", "valor": 27},
      {"label": "Qua", "valor": 25}
    ]
  }
}
```

#### 4. Métricas / Gauges
**Quando usar:** monitorar status em tempo real (CPU, RAM, disco, progresso, KPIs).
As barras mudam de cor por faixa: verde (<60%), amarelo (<85%), vermelho (>=85%).

```python
{
  "tipo": "metricas",
  "dados": {
    "titulo": "Status do Servidor",
    "metricas": [
      {"label": "CPU", "valor": 42, "unidade": "%"},
      {"label": "RAM", "valor": 6.8, "max": 8, "unidade": "GB"},
      {"label": "Disco", "valor": 540, "max": 600, "unidade": "GB"}
    ]
  }
}
```

#### 5. Alerta / Banner
**Quando usar:** notificar de algo importante (backup terminado, erro crítico,
aviso de espaço). Texto gigante chama atenção e a cor varia por severidade.

```python
{
  "tipo": "alerta",
  "dados": {
    "texto": "BACKUP OK",
    "nivel": "info",  # ou "aviso", "critico"
    "subtitulo": "Concluído com sucesso"
  }
}
```

#### 6. QR Code
**Quando usar:** compartilhar um link (acesso ao painel, doc) ou credencial
(Wi-Fi, token). O usuário aponta a câmera direto na tela.

```python
{
  "tipo": "qrcode",
  "dados": {
    "conteudo": "https://dashboard.exemplo.com",
    "legenda": "Aponte a câmera"
  }
}
```

#### 7. Tarefas / Checklist
**Quando usar:** lista de afazeres, checklist de deploy, roteiro de procedimento.
Mostra status (`✓`/`☐`) e prioridade colorida.

```python
{
  "tipo": "tarefas",
  "dados": {
    "titulo": "Checklist de Deploy",
    "itens": [
      {"texto": "Testes OK", "feito": true, "prioridade": "alta"},
      {"texto": "DB migration", "feito": false, "prioridade": "alta"},
      {"texto": "Notificar usuários", "feito": false}
    ]
  }
}
```

#### 8. Notícias
**Quando usar:** exibir manchetes de qualquer fonte (o agente busca os dados via API
ou ferramenta de busca). Lista numerada com título em destaque, resumo, categoria e
hora da publicação.

```python
{
  "tipo": "noticias",
  "dados": {
    "titulo": "Últimas Notícias",
    "fonte": "G1",
    "itens": [
      {"titulo": "Selic mantida em 13,75%",
       "resumo": "O Copom decidiu manter a taxa básica de juros.",
       "categoria": "Economia", "tempo": "há 30 min"},
      {"titulo": "Seleção convoca 26 jogadores",
       "resumo": "Lista com surpresas no ataque e ausências por lesão.",
       "categoria": "Esportes", "tempo": "há 2 horas"},
      {"titulo": "Tempestade causa apagão no Nordeste",
       "resumo": "Ventos de até 90 km/h derrubaram torres de transmissão.",
       "categoria": "Brasil"}
    ]
  }
}
```

#### 9. Jogos de futebol
**Quando usar:** mostrar a rodada atual, resultados ou agenda de qualquer campeonato.
Status colorido (`🔴 AO VIVO`, `✅ FIM`, `🕐 HH:MM`), placar em destaque e linha
de evento por partida.

```python
{
  "tipo": "jogos_futebol",
  "dados": {
    "titulo": "Rodada 15 — Brasileirão Série A",
    "data": "13/06/2026",
    "jogos": [
      {"time_casa": "Flamengo", "time_fora": "Palmeiras",
       "placar_casa": 2, "placar_fora": 1,
       "status": "encerrado", "estadio": "Maracanã",
       "destaque": "Gol de Gabriel Barbosa aos 78'"},
      {"time_casa": "Corinthians", "time_fora": "São Paulo",
       "placar_casa": 0, "placar_fora": 0,
       "status": "ao_vivo", "estadio": "Neo Química Arena",
       "destaque": "45+2' — 2º Tempo"},
      {"time_casa": "Atlético-MG", "time_fora": "Cruzeiro",
       "status": "agendado", "horario": "16:00", "estadio": "Arena MRV"},
      {"time_casa": "Botafogo", "time_fora": "Vasco",
       "status": "agendado", "horario": "18:30"}
    ]
  }
}
```

#### 10. Tela de boas-vindas customizável

A tela inicial (exibida no boot e ao pressionar `C`) mostra o logo do projeto com
informações de sistema. O agente pode personalizá-la e a customização persiste até
um reset ou reinício da TUI.

```python
# Personalizar: mudar cor do tema e mensagem de boas-vindas
{
  "acao": "set_welcome",
  "tipo": "boas_vindas",
  "dados": {
    "mensagem": "Sistema de produção — acesso restrito",
    "cor_tema":  "#ff5c7c",      # vermelho neon
    "subtitulo": "Monitoramento 24/7"
  }
}

# Restaurar o padrão com logo verde original
{"acao": "reset_welcome"}
```

Via `nc`:
```bash
# Personalizar
printf '{"acao":"set_welcome","tipo":"boas_vindas","dados":{"mensagem":"Olá!","cor_tema":"#00e5ff"}}\n' | nc 127.0.0.1 9999

# Resetar
printf '{"acao":"reset_welcome"}\n' | nc 127.0.0.1 9999
```

**Ver arquivo `examples.py` para payloads prontos de cada skill.**

---

## 🇬🇧 English (quick guide)

**Hermes Terminal Dashboard** is an MCP plugin that lets an AI agent render rich
Markdown on a physical monitor attached to a headless Linux device.

- `tui_display.py` — a Textual/Rich TUI that runs on the monitor and opens an internal
  asyncio TCP server (port `9999`) to receive commands. Cyberpunk-styled layout: header
  with live clock + connection status, a 70% Markdown panel, and a 30% activity log.
- `mcp_server.py` — an MCP server (official `mcp` SDK, stdio transport) exposing
  `atualizar_monitor`/`limpar_monitor` plus specialized **skills**: `exibir_previsao_tempo`
  (weather cards), `exibir_tabela` (rich table), `exibir_grafico` (bar chart),
  `exibir_metricas` (gauges), `exibir_alerta` (big-text banner), `exibir_qrcode`,
  `exibir_tarefas` (checklist), `exibir_noticias` (news feed with title + summary),
  and `exibir_jogos_futebol` (football matches with score and live status).
  It sends a newline-delimited JSON payload to the TUI.
- `renderers.py` — registry mapping each skill `tipo` to a Rich renderable (ncurses-style).

**Install**

```bash
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
```

**Run the TUI on TTY1** — recommended: use the `install.sh` script to set up getty@tty1
autologin + .bash_profile launcher (tested in production). Alternative: use the bundled
`hermes-tui.service` if you prefer systemd to claim `/dev/tty1` directly. Other options:
`openvt` or `tmux`.

**Wire it into the agent** — copy the `hermes-monitor` block from `config.example.json`
into your agent's `config.json` under `mcpServers`, pointing `args` at the absolute path
of `mcp_server.py`.

**Test**

```bash
printf '{"conteudo":"# Hello","log":"manual test"}\n' | nc 127.0.0.1 9999
mcp dev mcp_server.py
```

**Protocol** — newline-delimited JSON, one message per line:
`{"conteudo": "...", "log": "...", "acao": "update|clear"}`.

**Env vars** — `HERMES_TUI_HOST` (default `127.0.0.1`), `HERMES_TUI_PORT` (default
`9999`). **Keys** — `Q` quit, `C` clear panel.

**Troubleshooting**

- *getty@tty1 won't start on boot* — Create an override: `sudo systemctl edit getty@tty1`, add
  `[Service]`, `ExecStart=` (clear line), then `ExecStart=-/sbin/agetty --autologin <YOUR_USER> --noclear %I $TERM`,
  `Restart=always`, `RestartSec=3`. Reload: `sudo systemctl daemon-reload && systemctl is-active getty@tty1`.

- *TUI not appearing* — For option A (getty + .bash_profile): check `systemctl status getty@tty1` and
  `journalctl -u getty@tty1 -n 30 --no-pager`. Verify `.bash_profile` contains the launcher block. For option B
  (hermes-tui.service): check `systemctl status hermes-tui.service`. In both cases, verify venv and Python path.

- *Port 9999 in use* — Find owner: `ss -tlnp | grep 9999`. Change port via `HERMES_TUI_PORT=9998` env var in
  service file (option B) or `.service` override and agent config.