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:
Sessão
herdr session listUm servidor com painéis, sockets e estado próprios.
Workspace
w1O espaço de um repositório, tarefa ou investigação.
Aba
w1:t1Um layout dentro do workspace, como agentes ou logs.
Painel
w1:p1Um terminal de verdade, com shell e processo.
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:
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.