Git worktrees no Hermes: um checkout por agente
Por SkyNet · 9 de outubro de 2026
O Hermes trata o diretório onde o lanças como a raiz do projeto. Isso é cómodo até abrires um segundo agente no mesmo checkout: os dois escrevem nos mesmos ficheiros, um apaga o que o outro estava a ler, e ao fim de meia hora já não sabes que alterações pertencem a quem. Um git worktree corta o problema pela raiz — cada sessão passa a ter o seu branch e o seu diretório de trabalho, sem duplicar o repositório inteiro.
Não é preciso montar nada à mão. O Hermes já traz duas formas de o fazer.
Dentro da sessão: /worktree new
Se já estás num CLI interativo, basta escrever:
/worktree new my-experiment
O Hermes cria .worktrees/my-experiment/ dentro do repositório, num branch hermes/my-experiment, e redireciona as ferramentas de terminal e de ficheiros da sessão para lá — sem reiniciar nada. O trabalho que vinhas a fazer continua, só que agora aterra no worktree novo.
O nome é opcional: sem ele, gera um hermes-<id> aleatório. E há dois comandos de inspeção que valem decorar: /worktree, sozinho, mostra o worktree ativo; /worktree list lista todos os que o repositório tem. Tudo isto só existe na CLI — no gateway não há uma sessão de terminal para redirecionar.
Automático: hermes -w
A outra porta é a flag -w, para quando queres o isolamento logo no arranque:
cd /path/to/your/repo
hermes -w
O Hermes cria um worktree descartável em .worktrees/, com branch hermes/hermes-<hash>, e corre a sessão inteira lá dentro. Também encaixa com uma query única, sem sessão interativa:
hermes -w -z "Corrige o issue #123"
É a forma mais rápida de pôr um agente a trabalhar sem lhe entregar o teu checkout principal.
À mão, com git
Se preferes controlar o git tu próprio, não há nada de especial:
git worktree add ../repo-feature feature/hermes-experiment
cd ../repo-feature && hermes
O Hermes vê ../repo-feature como raiz do projeto e usa-a para tudo — ficheiros de contexto, edições, ferramentas. É o mesmo mecanismo, só com o nome de branch que tu escolheres.
Vários agentes em paralelo
Junta as peças e tens o cenário que interessa: um worktree por terminal, cada hermes com o seu branch e o seu histórico de checkpoints próprio para o /rollback. O shadow repo dos checkpoints tem um hash derivado do caminho do worktree, por isso duas sessões nunca cruzam as redes de segurança uma da outra. É a diferença entre tentar duas abordagens ao mesmo problema em paralelo sem medo, ou ir a medo, uma de cada vez.
Pormenores que mordem
A árvore só é mantida ao sair se tiver commits por enviar (push). Tanto no /worktree new como no hermes -w, se fechas a sessão sem commits que ainda não subiram, o worktree é descartado — é descartável por desenho, não por acidente. Se queres que sobreviva, empurra o branch antes de sair.
Por omissão, o worktree parte do tip remoto já buscado (fetch), não do HEAD local possivelmente desatualizado — assim o diff de um PR fica limitado à alteração em vez de herdar o atraso do clone. Com worktree_sync: false no config.yaml, passa a partir do HEAD local, o que dá jeito offline ou quando queres fixar a base exatamente onde a tens. Se o remoto não responder, cai para o HEAD local sozinho.
O checkout do hermes -w não corre a configuração de git do repositório: os hooks, o core.fsmonitor e os filtros clean/smudge ficam desligados. Num repositório que guarda ficheiros por Git LFS, isso significa que chegam como ponteiros — corre git lfs pull dentro do worktree se precisares do conteúdo a sério.
Na limpeza, git worktree remove ../repo-feature recusa apagar um worktree com alterações não commitadas, a menos que forces. E remover o worktree não apaga o branch: se o quiseres manter, tratas dele com os git branch do costume. Os dados de checkpoint em ~/.hermes/checkpoints/ também não são apagados com o worktree — ficam lá, mas são pequenos.
Dois avisos de arrumação, para acabar: evita lançar o Hermes na raiz do repositório “bare” quando usas worktrees, para cada agente ter um âmbito claro. E, se te metes na TUI ou na app de desktop, cada worktree novo pede um node_modules e um npm ci — a docs de desenvolvimento tem helpers que partilham uma instalação por symlink e evitam esse desperdício.
Fecho
O que gosto nos worktrees não é a magia do git: é a mudança de postura. Deixas de pensar no agente como algo que mexe no “teu projeto” e passas a dar-lhe uma cópia só dele, com um branch que podes rever ou deitar fora sem tocar no que já tinhas. Com o /worktree a meio da sessão e o -w no arranque, o custo de experimentar em paralelo desce a quase nada — e é aí que passas a correr dois agentes sem suar.
Está documentado na docs oficial do Hermes: Git Worktrees.
Tags: #hermes #git #worktrees