Herdr Desktop: a janela dos agentes

O Herdr Desktop reúne os projetos e os terminais em uma janela nativa. Você inicia o Claude Code ou o Codex pelo botão de adicionar uma aba e acompanha os agentes na lateral. O herdr-core mantém os terminais ativos quando você fecha a janela do aplicativo.

Instale o aplicativo

Você pode baixar o Herdr Desktop na página oficial de downloads. Confira a compatibilidade com o seu computador:

O aplicativo para o macOS está disponível apenas para os processadores Apple silicon.

Use o instalador do aplicativo no macOS ou no Linux:

1
curl -fsSL https://releases.herdr.dev/app/install.sh | sh

No Windows, execute:

1
powershell -c "irm https://releases.herdr.dev/app/install.ps1 | iex"

O instalador inclui o herdr-core quando ele ainda não está disponível. Instale e autentique o agente de código que pretende usar. Depois, abra o Herdr Desktop e adicione uma aba pelo botão +.

Entenda o papel do herdr-core

A janela apresenta os terminais mantidos pelo herdr-core. Fechar ou atualizar a janela preserva os processos enquanto o core e a máquina permanecem ativos. Reiniciar o computador encerra esses processos. Ao recuperar a organização da janela, o aplicativo pode reabrir shells nos diretórios anteriores, mas não reinicia agentes nem retoma tarefas automaticamente.

O comando hc permite consultar esses terminais fora da janela:

1
hc ls

Para executar testes em um terminal mantido pelo core, entre no diretório de um projeto Rust e use:

1
hc run --bg --name testes cargo test
2
hc attach testes

A combinação Ctrl+\ desconecta a visualização do terminal. A execução continua se o processo ainda estiver ativo. O core apresenta o estado de um programa quando recebe essa informação pelo protocolo OSC 7501.

Personalize o aplicativo com o agente

O arquivo ~/.config/herdr-app/AGENTS.md orienta o agente sobre a interface instalada. Depois de ler essas instruções, ele pode alterar a apresentação dos painéis ou acrescentar um mod. Uma personalização possível é acrescentar um indicador do tempo de trabalho a cada aba. Você pode solicitar essa alteração ao agente e conferir o resultado na janela.

Os layouts e os mods distribuídos pelo Herdr recebem atualizações do aplicativo. Para modificar a estrutura ou o código de um deles, o agente deve criar uma cópia própria. Você pode alterar a aparência pelas configurações do aplicativo sem duplicar o layout.

Esses caminhos partem de ~/.config/herdr-app/. Consulte o guia de mods e layouts para experimentar as composições do catálogo e preservar suas alterações.

Use a referência da edição certa

O Herdr Desktop e o Herdr TUI têm comandos e servidores próprios. Uma sessão criada com herdr pertence ao Herdr TUI. Os terminais consultados por hc pertencem ao herdr-core.

O comando hc --skill exibe as instruções para operar os terminais. Já o comando herdr-app --skill apresenta a referência do aplicativo. Consulte o guia de skills para orientar o agente conforme a tarefa.