Verboo Code: como bifurcar uma conversa com /branch sem perder a original
Voltar para o Blog
Artigoverboo codetutorialdev toolshow to

Verboo Code: como bifurcar uma conversa com /branch sem perder a original

Mafra15 de outubro de 20264 min de leitura

Você está no meio de uma sessão longa, o agente já entendeu o projeto, e surge a dúvida: e se a gente trocasse o cache em memória por Redis? Testar isso na mesma conversa mistura as duas ideias no histórico. Abrir uma sessão nova joga fora todo o contexto. O /branch da Verboo Code resolve o meio do caminho: copia a conversa inteira até aquele ponto e te coloca na cópia, com a original guardada intacta.

O que o /branch faz na Verboo Code?

Ele cria uma nova sessão com todas as mensagens da conversa atual, gera um ID novo para ela e já te leva para dentro dessa cópia. A sessão original não é alterada e continua disponível no /resume.

Por baixo, a CLI lê o arquivo da sessão atual, copia as mensagens da conversa principal para um arquivo novo e marca cada uma com a origem (forkedFrom, com o ID da sessão e da mensagem originais). As duas sessões ficam no mesmo diretório de projetos, em ~/.claude/projects/, ou no caminho de VERBOO_PROJECTS_DIR se você definiu essa variável.

Como bifurcar a conversa, passo a passo?

Dentro da sessão, digite /branch seguido de um nome opcional:

/branch teste-redis

A CLI responde com Branched conversation "teste-redis". You are now in the branch. e, na linha seguinte, mostra o ID da sessão original. A partir daí, tudo o que você pedir fica só no branch.

Fluxograma do /branch na Verboo Code: /branch teste-redis cria a cópia e já entra nela, /resume mostra a original e o branch lado a lado, verboo -r com o ID abre a original direto; fora da sessão, verboo -c --fork-session bifurca pelo terminal
O /branch cria a cópia e já te coloca nela. Para voltar, use o /resume ou o ID que a CLI mostrou. Fora de uma sessão, --fork-session faz o mesmo pelo terminal.

Qual nome o branch recebe?

O nome que você passar, ou a primeira mensagem da conversa se não passar nada, sempre com o sufixo (Branch). Se já existir um branch com o mesmo nome, a CLI numera o próximo.

Você digitaTítulo da nova sessão
/branch teste-redisteste-redis (Branch)
/branch teste-redis de novoteste-redis (Branch 2)
/branch sem nomeaté 100 caracteres da primeira mensagem, mais (Branch)

Dar nome vale a pena: é o título que aparece no seletor do /resume, e é por ele que você vai achar a cópia depois.

Como voltar para a conversa original?

Pelo seletor de sessões ou direto pelo ID. As duas aparecem na lista, a original com o título de sempre e a cópia com (Branch) no fim:

/resume

Ou, do terminal, com o ID que a CLI mostrou na hora de bifurcar:

verboo -r <id-da-sessao-original>

Se a sessão for de outro projeto, o guia de /resume entre projetos mostra como achar e retomar.

Dá para bifurcar sem estar dentro da sessão?

Dá, com --fork-session. Ele funciona junto com --continue ou --resume e abre a sessão escolhida com um ID novo, em vez de continuar escrevendo na mesma:

# bifurca a sessão mais recente desta pasta
verboo -c --fork-session

# bifurca uma sessão específica
verboo -r <session-id> --fork-session

Se quiser escolher o ID da cópia, --session-id só é aceito junto com --continue ou --resume quando --fork-session também está na linha.

Armadilha: o /branch copia a conversa, não o código. Ele não cria branch do git, não copia arquivo e não isola a pasta. Se o agente editar arquivos no branch, as edições caem no mesmo diretório que a sessão original usa. Para testar uma alternativa de código sem sujar a original, crie antes uma branch do git ou uma worktree:

git switch -c teste-redis
# ou, numa pasta separada:
git worktree add ../meu-projeto-redis -b teste-redis

Se o problema for só desfazer uma edição que o agente acabou de fazer, o caminho é o /rewind.

Quando usar /branch em vez de /clear ou de uma sessão nova?

SituaçãoComandoPor quê
Testar outra abordagem sem perder o raciocínio da atual/branchAs duas linhas guardam o contexto completo até o ponto da bifurcação
Assunto novo, sem relação com a conversa/clearContexto anterior só atrapalharia
Conversa longa demais, mas no mesmo assunto/compactResume o histórico e segue na mesma sessão
Desfazer a última edição do agente/rewindVolta o código e a conversa a um ponto anterior

Cada branch é uma conversa inteira seguindo em paralelo, com o histórico completo sendo lido de novo pelo modelo a cada mensagem. Na Verboo Code os planos rodam com token ilimitado, então testar a terceira abordagem custa o mesmo que testar a primeira.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados