Ir para o conteúdo
Promovaweb

Como o Herdr estrutura os terminais dos agentes

O Herdr TUI é um gerenciador de terminais para agentes de código. Um servidor em segundo plano mantém os terminais e os processos vivos, enquanto o cliente desenha a interface no seu terminal. Em volta desses terminais reais, o Herdr monta uma estrutura de workspaces, abas e painéis e reconhece os agentes que rodam em cada painel.

Servidor e cliente

Quando você roda herdr no terminal, o comando procura o servidor da sessão padrão e, se ele ainda não existe, inicia esse servidor em segundo plano. O servidor é dono dos painéis e dos processos que rodam dentro deles. O cliente é a interface que aparece na sua janela de terminal, ligada a esse servidor por um socket local que você não precisa configurar.

Essa separação explica o comportamento mais útil do Herdr. Ao desconectar o cliente com ctrl+b q, a janela fecha e o servidor continua rodando, com o agente, os testes e o servidor de desenvolvimento ainda ativos. Rodar herdr de novo reconecta a interface aos mesmos painéis. O comando herdr server stop faz o contrário, porque encerra o servidor e os processos de todos os painéis da sessão.

Vários clientes podem ficar ligados ao mesmo servidor ao mesmo tempo, cada um olhando para o próprio workspace e a própria aba. Quando dois clientes abrem a mesma aba, o último que interagiu com ela define o tamanho dos painéis.

Da sessão ao painel

O Herdr distribui os terminais em camadas. Cada camada tem uma função própria e um identificador que a linha de comando e a Socket API usam para chegar ao terminal certo:

  1. Sessão

    herdr session list

    Um servidor com painéis, sockets e estado próprios.

  2. Workspace

    w1

    O espaço de um repositório, tarefa ou investigação.

  3. Aba

    w1:t1

    Um layout dentro do workspace, como agentes ou logs.

  4. Painel

    w1:p1

    Um terminal de verdade, com shell e processo.

As camadas do Herdr TUI, da mais ampla à mais específica. Os identificadores aparecem nas respostas em JSON da linha de comando.

O workspace é a unidade que você mais usa. A documentação recomenda um workspace por repositório, tarefa ou investigação. O estado dos agentes de dentro dele sobe para a barra lateral, o que mostra de longe qual projeto precisa de você. As abas separam visões do mesmo projeto, como uma aba para os agentes, outra para o servidor de desenvolvimento e outra para a revisão.

O painel é um terminal real. O Herdr desenha a saída do processo, envia o que você digita e preserva o painel quando o cliente desconecta. Você divide um painel à direita ou para baixo, renomeia, lê a saída pela linha de comando e fecha quando o processo termina. Os identificadores de abas e painéis fechados não voltam a ser usados, por isso um script que guardou w1:p3 não atinge outro terminal por engano depois que esse painel some.

As sessões nomeadas são servidores independentes. Para separar projetos, a documentação indica primeiro os workspaces. A sessão nomeada fica para o caso de um projeto que precisa de outro servidor, com sockets e estado próprios, como o trabalho de um cliente que não pode dividir servidor com outro. As sessões compartilham o mesmo arquivo de configuração.

O agente dentro do painel

O Herdr chama de agente um processo que ele reconhece dentro de um painel. A detecção olha o processo em primeiro plano, compara o fim da tela com o manifesto de detecção de cada ferramenta e, quando a integração oficial está instalada, também recebe o estado reportado pela própria ferramenta. Um painel existe com ou sem agente. Quando o Claude Code sai e o shell volta para o primeiro plano, o painel continua ali e deixa de aparecer como agente.

Cada agente reconhecido tem um de cinco estados. O estado sobe do painel para a aba e da aba para o workspace, de modo que a barra lateral mostra qual projeto tem um agente parado à espera de resposta:

EstadoO que o Herdr reconheceuO que você faz
workingO agente está executando uma tarefa.Acompanha a saída ou cuida de outro projeto.
blockedA tela mostra uma aprovação, uma pergunta ou um aviso de permissão.Lê a tela e responde ao agente.
doneO agente terminou e o resultado ainda não foi visto.Abre o painel e confere o que mudou.
idleO agente terminou ou aguarda e o painel já foi visto.Envia a próxima tarefa quando quiser.
unknownExiste um agente no painel, mas a tela não permite classificar.Lê o terminal antes de enviar qualquer texto.

A diferença entre done e idle está apenas na visualização. Os dois estados indicam que o agente aceita uma nova entrada. Cada cliente registra quais conclusões já exibiu, então abrir o resultado num cliente não apaga o selo de concluído no outro.

Mouse, teclado e os três modos

A interface do Herdr TUI aceita mouse em tudo. Você clica em painéis, abas, workspaces e agentes, arrasta a divisória entre painéis, seleciona texto e abre menus com o botão direito. O teclado é uma camada opcional sobre essa interface.

Os atalhos usam um prefixo, ctrl+b por padrão, como no tmux. O Herdr trabalha em três modos. No modo de terminal, as teclas vão para o painel em foco. Depois do prefixo, o modo de prefixo espera uma ação, como c para uma aba nova ou w para navegar entre workspaces. O modo de navegação fica aberto para percorrer os workspaces com as setas. A referência completa dos atalhos padrão está em Atalhos do Herdr TUI. A página Personalização explica como trocar o prefixo ou desligar a captura do mouse.

O que fica fora do Herdr

O Herdr executa os agentes que você instalou no ambiente. A instalação, a autenticação e a cobrança do Claude Code, do Codex ou do OpenCode continuam com cada ferramenta. Abrir o Herdr não dá acesso a nenhum desses serviços. As permissões do agente também são as do usuário do sistema que abriu o painel.

Um agente sem suporte do Herdr roda normalmente num painel e aparece como um terminal comum, sem estado. As ferramentas que o Herdr reconhece, os níveis de suporte de cada uma e as integrações estão na página Agentes de código. As diferenças entre o Herdr TUI, o Herdr Core e o Herdr Desktop, com as plataformas de cada edição, estão em Edições e plataformas.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.