Verboo Code: como dar nome a uma sessão com /rename e voltar a ela pelo nome
Voltar para o Blog
Artigoverboo codetutorialagente de programaçãodev toolsprodutividade

Verboo Code: como dar nome a uma sessão com /rename e voltar a ela pelo nome

Mafra2 de novembro de 20266 min de leitura

Você abre o /resume e encontra uma lista de sessões que começam todas com "corrige", "olha esse erro" ou "continua". Qual delas era a do login com OAuth? O /rename resolve isso: dá um nome à sessão atual da Verboo Code e, a partir daí, você volta a ela digitando o nome, sem caçar na lista.

O que o /rename faz?

Ele grava um nome para a sessão atual. Esse nome aparece no seletor do /resume, no /status, na barra do prompt e no comando de retomada que a CLI imprime quando você sai.

/rename login-oauth

A resposta é:

Session renamed to: login-oauth

O nome que você digita é gravado como está, só sem espaços nas pontas. Pode ter espaço no meio (/rename login com oauth), mas nome sem espaço é mais fácil de digitar depois no terminal.

E se eu rodar /rename sem nome?

A Verboo Code lê a conversa e sugere um nome curto em kebab-case, de 2 a 4 palavras, como fix-login-bug ou refactor-api-client. Desde a versão 0.15.40, essa sugestão usa o modelo fast do catálogo, quando ele existe.

/rename

Duas mensagens podem aparecer no lugar do nome:

MensagemPor quêO que fazer
Could not generate a name: no conversation context yet. Usage: /rename <name>A sessão ainda não tem conversa para resumirMande o primeiro pedido antes, ou passe o nome você mesmo
Could not generate a name: the model request failed. Try again or use /rename <name>A chamada ao modelo falhouRode de novo ou digite o nome

A segunda mensagem é nova da 0.15.40. Antes, uma falha do modelo aparecia como se a sessão não tivesse contexto.

Fluxograma do /rename na Verboo Code: dar um nome com /rename login-oauth, sair e ver o comando Resume this session with, voltar com verboo --resume login-oauth da mesma pasta. Se o nome for parcial ou repetido, abre o seletor com a busca preenchida, Ctrl+R renomeia e Ctrl+A mostra todos os projetos
Do nome à retomada, e o que acontece quando o nome não bate exatamente.

Como voltar a uma sessão pelo nome?

Pelo terminal, com --resume e o nome:

verboo --resume login-oauth

Você nem precisa decorar: ao sair de uma sessão com nome, a CLI imprime o comando pronto, já com aspas:

Resume this session with:
verboo --resume "login-oauth"

Sessão sem nome mostra o mesmo aviso com o ID (um UUID), que ninguém lembra. É a diferença prática do /rename.

Dentro de uma sessão aberta, o equivalente é:

/resume login-oauth

Ao digitar /resume seguido de um espaço e parte do nome, a CLI sugere até 10 sessões cujo nome contém o que você digitou, da mais recente para a mais antiga.

Como o nome é comparado?

Por igualdade exata, sem diferenciar maiúscula de minúscula. Login-OAuth acha login-oauth, mas login sozinho não acha. O que acontece em cada caso:

Situaçãoverboo --resume nome/resume nome
Um nome igualRetoma a sessão diretoRetoma a sessão direto
Nenhum nome igualAbre o seletor com nome já na buscaSession nome was not found.
Duas ou mais sessões com o mesmo nomeAbre o seletor com nome já na buscaFound 2 sessions matching nome. Please use /resume to pick a specific session.

Por isso vale um nome por tarefa. Se você usa bug em toda sessão de correção, o retorno direto nunca acontece.

Armadilha: a busca pelo nome olha as sessões do repositório onde você está, incluindo os worktrees dele. Rodar verboo --resume login-oauth de outra pasta não acha a sessão e cai no seletor. Volte para a pasta do projeto ou, no seletor, aperte Ctrl+A para ver todos os projetos. Retomar sessão de outro projeto tem o seu próprio caminho, explicado em como retomar uma sessão aberta em outro projeto.

Dá para dar o nome já ao abrir a sessão?

Dá, com -n ou --name:

verboo -n login-oauth

O nome aparece no /resume e no título da janela do terminal, e é gravado no arquivo da sessão junto com a primeira mensagem que você mandar. Bom para quem abre uma sessão por tarefa e já sabe o nome antes de começar.

Como renomear uma sessão antiga sem abrir ela?

Pelo seletor do /resume. Selecione a sessão com as setas e aperte Ctrl+R. Aparece Rename session:, você digita o nome novo e confirma com Enter (ou cancela com Esc). O seletor tem mais atalhos que ajudam a achar a sessão antes de renomear:

AtalhoO que faz
Ctrl+RRenomeia a sessão selecionada
Ctrl+VMostra uma prévia da conversa
Ctrl+AAlterna entre a pasta atual e todos os projetos
Ctrl+BFiltra pela branch atual do git
digitarBusca no nome, no resumo, no primeiro pedido e na branch

A sessão já ganha um título sozinha?

Ganha. Desde a 0.15.40, a Verboo Code gera um título para a sessão em segundo plano e mostra no /resume. Na 0.15.41, o título passou a sair no idioma da conversa. Se a geração falhar, o título vira o seu primeiro pedido.

O /rename continua valendo mais: o código grava os dois em campos separados e, na leitura, o nome que você deu sempre ganha do título automático. Para retomar pelo nome com --resume sem surpresa, use um nome que você mesmo escolheu.

Se você usa CLAUDE_CODE_DISABLE_TERMINAL_TITLE para não mexer no título da janela do terminal, saiba que desde a 0.15.41 essa variável só faz isso. A sessão continua ganhando título no /resume.

Onde mais o nome aparece?

  • /status: linha Session name. Sem nome, ela mostra a dica /rename to add a name.
  • Status line: o JSON que o seu script recebe traz o campo session_name quando a sessão tem nome. Dá para mostrar o nome da tarefa embaixo do prompt, como no tutorial de status line com /statusline.
  • Barra do prompt: o nome fica visível na própria sessão enquanto você trabalha.

Como usar o /rename no dia a dia?

Um fluxo que funciona bem com /clear, que limpa o contexto mas não apaga a sessão anterior:

/rename login-oauth      # nomeia a sessão atual antes de mudar de assunto
/clear                   # começa uma conversa limpa para a próxima tarefa
/resume login-oauth      # volta ao login quando precisar

Para bifurcar uma conversa e testar outro caminho sem perder a original, o comando é outro: /branch. Dê nomes diferentes às duas pontas e o /resume fica legível.

Sessão com nome é sessão que você retoma no dia seguinte sem reexplicar o problema ao agente. Para trabalhar assim, em quantas sessões precisar, crie a conta na Verboo Code e rode /rename na primeira.

Comportamento verificado no código-fonte da Verboo Code (verbeux-ai/code, v0.15.41) em 02/11/2026: src/commands/rename, src/commands/resume, src/components/LogSelector.tsx, src/utils/gracefulShutdown.ts e src/main.tsx.

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

Artigos relacionados