Plugin Omaherdr no Omarchy

O Omaherdr traz para a barra do Omarchy o que está acontecendo nas sessões do herdr. O ícone mostra luzes de estado, como um semáforo: vermelho quando um agente espera resposta, amarelo enquanto trabalha, verde quando termina e cinza quando está parado. Clicar no ícone ou nos contadores abre o painel.

A descoberta é automática. O plugin procura processos do herdr nas janelas de terminal abertas, encontra sessões simples, sessões nomeadas com --session e sessões remotas com --remote, e conversa com cada servidor pelo socket. Um servidor local sem ninguém conectado também aparece na lista.

Antes de instalar

O Omaherdr exige Omarchy 4 com shell Quickshell, herdr 0.8 ou mais recente e python3. Para acompanhar máquinas remotas, a chave SSH precisa funcionar sem solicitar senha e o host remoto precisa ter python3 instalado. Não há outra dependência.

Instale e reinicie o shell

1
omarchy plugin add https://github.com/njpatel/omaherdr.git --enable
2
omarchy restart shell

Depois da instalação não há configuração obrigatória. O widget já identifica as sessões em uso e começa a acompanhar os eventos do herdr, então a barra muda assim que um agente para em uma pergunta ou conclui a tarefa.

Use o painel

Clique no ícone ou nos contadores para abrir a lista. Dentro do painel:

O salto foca primeiro a janela do terminal que hospeda o cliente do herdr e, quando o terminal permite, a aba ou o painel exato. O campo since mostra há quanto tempo o agente está no estado atual, medido dali.

Terminais reconhecidos

O README registra os testes feitos em Omarchy com Hyprland 0.56:

Em outros terminais o salto chega à janela. As janelas são identificadas pela árvore de processos do cliente, o que funciona para sessões locais, nomeadas e remotas. Com mais de uma janela ligada ao mesmo servidor, a escolha considera o título do herdr, o workspace atual e o foco mais recente. A opção preferTerminal resolve a dúvida quando você usa sempre o mesmo terminal:

1
omarchy bar set njpatel.omaherdr preferTerminal ghostty

Ajuste o que a barra mostra

As configurações ficam na entrada do widget em ~/.config/omarchy/shell.json e podem ser alteradas pela linha de comando:

1
omarchy bar set njpatel.omaherdr barMetric all
2
omarchy bar set njpatel.omaherdr barStyle lights
3
omarchy bar set njpatel.omaherdr scanIntervalSec 30

barMetric aceita attention, active, all e none. Em attention, aparecem as luzes vermelha e verde. active soma o amarelo. all inclui o cinza. scanIntervalSec define de quanto em quanto tempo o plugin procura sessões novas ou encerradas, com 10 segundos como padrão.

Para atualizar:

1
omarchy plugin update njpatel.omaherdr

Remova o Omaherdr

1
omarchy plugin remove njpatel.omaherdr

O comando não apaga o estado em ~/.local/state/omarchy/omaherdr/. Se quiser limpar também esse diretório, remova a pasta depois.