Você pede uma tarefa grande, responde duas perguntas no meio do caminho, aprova um comando, e quando percebe o agente está polindo um detalhe que não tinha nada a ver com o pedido. O /goal, que chegou na Verboo Code na versão 0.15.35 (30/09/2026), resolve isso: você grava um objetivo para a sessão e ele volta para o agente a cada turno até você fechar. Este guia mostra os comandos, o que acontece por trás e o que fazer quando o objetivo trava.
O que o /goal faz na Verboo Code?
Ele grava um objetivo persistente para a sessão atual e reinjeta esse objetivo no contexto do agente a cada turno, enquanto estiver ativo. O agente começa a trabalhar nele na hora, sem você precisar mandar outra mensagem.
A descrição no código é literal: "Set and track a persistent goal for this session". Enquanto o objetivo está ativo, o rodapé da CLI mostra Goal active: em verde, seguido de um resumo de até 54 caracteres do que você pediu.
Como definir um objetivo?
Escreva o objetivo logo depois do comando. Seja específico sobre o que conta como pronto, porque é esse texto que o agente vai reler a cada turno.
/goal migrar o módulo de pagamentos de callbacks para async/await, com todos os testes de src/payments passandoA CLI responde Goal set: com o texto gravado e o agente já começa. Se já existia um objetivo em aberto com outro texto, a resposta é Goal replaced:: o novo substitui o antigo, não soma.
Quais são todos os comandos do /goal?
São sete formas, todas lidas do help da própria CLI (/goal help):
| Comando | O que faz |
|---|---|
/goal <objetivo> | Define ou substitui o objetivo e começa a trabalhar nele |
/goal ou /goal status | Mostra o objetivo atual e o status |
/goal pause | Pausa: o objetivo para de ser reinjetado, o rodapé fica amarelo |
/goal resume | Retoma um objetivo pausado ou travado e o agente volta a trabalhar |
/goal complete | Marca como concluído; o rodapé some |
/goal clear | Apaga o objetivo (aceita também stop, off, reset, cancel) |
Como saber em que pé está o objetivo?
Olhe o rodapé ou rode /goal status. O status é um de quatro, e cada um tem uma cor:
/goal status| Status | Rodapé | O agente recebe o objetivo? |
|---|---|---|
active | verde | Sim, a cada turno |
paused | amarelo | Não |
blocked | vermelho | Sim, com a instrução de parar de tentar e pedir ajuda |
completed | some | Não |
O agente pode fechar o objetivo sozinho?
Pode marcar como concluído, mas só quando o objetivo foi de fato atingido. Para isso a Verboo Code dá ao agente uma ferramenta interna, GoalUpdate, que aceita três status: complete, paused e blocked.
O lembrete que vai junto com o objetivo diz ao agente para não pausar a não ser que você peça. E só a sessão principal mexe no objetivo: subagentes não recebem o lembrete e, se tentarem atualizar, recebem "Only the main session can update its persistent goal." Se quiser fechar você mesmo, rode /goal complete.
O que fazer quando o objetivo fica blocked?
Corrija a causa e rode /goal resume. O status blocked só aparece quando o mesmo bloqueio se repete em 3 turnos seus seguidos, e a partir daí o agente para de insistir e pergunta o que falta.
A regra está no código: na primeira e na segunda vez que o agente esbarra no mesmo problema (uma credencial ausente, um serviço fora do ar, um teste que depende de algo que só você tem), o bloqueio é só registrado e ele continua tentando outros caminhos. Na terceira seguida, o objetivo vira blocked e o motivo aparece no /goal status, na linha Blocker:.
/goal status
/goal resumeO resume limpa o bloqueio registrado e devolve o objetivo para active. Se o objetivo já estava concluído, ele não reabre: a CLI responde "This goal is already complete. Set a new goal with /goal <objective>."
Onde o objetivo fica salvo?
Num arquivo JSON por sessão, em ~/.verboo/goals/<id-da-sessão>.json, com permissão só para o seu usuário (600). Se você define VERBOO_CONFIG_DIR, a pasta goals/ fica dentro dele.
Isso tem uma consequência prática: o objetivo não vive só na memória do processo, então dá para conferir o que foi gravado direto no disco.
cat ~/.verboo/goals/*.jsonQuando usar /goal e quando não usar?
Use em tarefa de várias etapas em que você vai interagir no meio: migração, refatoração com testes, correção de um conjunto de issues. Para pedido de uma resposta só, não precisa: o objetivo só ocupa espaço no contexto.
Ele combina bem com o /compact. O resumo da compactação pode perder o detalhe do pedido original; o objetivo do /goal continua sendo reinjetado depois. E se o agente se perder numa edição ruim no caminho, o /rewind desfaz sem você abandonar o objetivo.
Objetivo persistente faz mais diferença justamente nas sessões longas, que são as que mais gastam token. Na Verboo Code o plano tem token ilimitado, então o agente pode levar o objetivo até o fim sem você vigiar cota: crie a conta em verboo.ai, atualize a CLI e rode /goal na próxima tarefa grande.
