Passar o trabalho e reiniciar

Um contexto novo para o seu agente,
sem perder o fio

Três horas depois do início de uma tarefa, o contexto está cheio de logs velhos e de tentativas abandonadas, e o agente começa a esquecer o que decidiu. Você quer que ele recomece limpo, mas não do zero.

Passar o trabalho e reiniciar faz a passagem por você: o agente escreve onde está num arquivo do projeto, depois o console dele inicia uma conversa nova na mesma aba, e a primeira mensagem diz a ele para ler esse arquivo e continuar. Um clique, uma confirmação, no Claude Code, no Codex e em qualquer CLI de agente que tenha as ferramentas do AgentsRoom.

Menu de clique com o botão direito de um agente em execução no AgentsRoom, com Hand over and restart abaixo de Fork e a sua descrição: o agente escreve as notas de passagem e depois recomeça numa conversa nova
Clique com o botão direito num agente em execução: Passar o trabalho e reiniciar está no menu dele, no computador e no celular.

Sessões longas se desgastam. Cada arquivo que o agente leu, cada log de teste que ele exibiu e cada abordagem que tentou e abandonou fica na janela de contexto dele. Em algum momento, a parte útil, as decisões e o plano, fica enterrada sob o resto, e as respostas pioram.

A solução habitual é uma passagem manual: pedir ao agente que escreva um resumo num arquivo, digitar /clear e depois colar uma primeira mensagem que diga à nova conversa para ler esse resumo. Funciona, e há quem escreva skills e prompts de handoff para ir mais rápido, mas isso ainda tira você do seu trabalho: três passos por agente, toda vez.

No AgentsRoom, é uma entrada de menu. O próprio agente escreve as notas de passagem, porque sabe o que importa no próprio contexto, e reinicia sozinho quando o turno dele termina. Você mantém o controle de uma coisa: a primeira mensagem com que a nova conversa começa.

Gravado no app real: um agente do Claude Code faz os passos 1 e 2 de um refactor em três passos, depois um clique com o botão direito nele, Passar o trabalho e reiniciar e uma única confirmação. Ele escreve num arquivo do projeto onde está, o que decidiu e o que falta fazer, e o console dele reinicia na mesma aba com uma conversa nova. Ele lê esse arquivo, segue para o passo 3, e 5 de 5 testes passam.

Assistir no YouTube

O que Passar o trabalho e reiniciar faz

Um contexto limpo que parte do que o agente sabia, não do zero.

Um clique em vez de três passos

Clique com o botão direito num agente em execução, escolha Passar o trabalho e reiniciar, confirme. Nada de /clear para digitar, nada de resumo para pedir, nada de prompt para colar. O console recomeça na mesma aba, com o mesmo papel, a mesma CLI e o mesmo modelo.

Notas de passagem escritas pelo agente

O agente escreve onde está, as decisões que tomou e o que falta fazer, num arquivo do projeto: o próprio arquivo de passagem, se a rotina dele mantém um, senão .handoff/latest.md. O arquivo fica no disco, então você também pode lê-lo.

A sua primeira mensagem, salva por agente

A nova conversa se abre com "Read your handover and continue" seguido do caminho do arquivo. Mude-a na janela e ela fica salva para esse agente, em todos os computadores da sua conta e no celular.

As mensagens esperam a nova conversa

A partir do momento em que o agente começa a passagem, as mensagens que você ou outros agentes enviam a ele ficam retidas e são entregues à próxima conversa dele: nada cai na antiga no último segundo.

Um coordenador pode pedir, nunca decidir

O agente coordenador de um projeto pode pedir uma passagem para um colega de equipe, por exemplo quando o contexto dele está cheio. A mesma janela se abre com o nome do coordenador e o motivo dele, e nada acontece até você clicar em Passar o trabalho e reiniciar.

Qualquer CLI com as ferramentas do AgentsRoom

O reinício passa pelas ferramentas do AgentsRoom, não por um comando de uma CLI específica, então funciona do mesmo jeito no Claude Code, no Codex e nas outras CLIs de agente que as carregam. Uma CLI que não as tem avisa, e você digita /clear no console dela no lugar.

Como funciona

Quatro passos, e você só faz os dois primeiros.

  1. 1

    Abra o menu do agente

    Clique com o botão direito num agente que está rodando neste computador e escolha Passar o trabalho e reiniciar. No celular, faça um toque longo no agente e escolha a mesma entrada.

  2. 2

    Confira a primeira mensagem

    A janela mostra a Primeira mensagem da próxima conversa, "Read your handover and continue" por padrão. Edite-a se este agente precisar de outra coisa, ela fica guardada para a próxima vez, e depois clique em Passar o trabalho e reiniciar.

  3. 3

    O agente escreve as notas de passagem

    O AgentsRoom pede ao agente que escreva as notas de passagem num arquivo do projeto e que encerre o turno. A partir daí, as mensagens para ele esperam a próxima conversa dele.

  4. 4

    O console recomeça

    Quando o turno termina, o console reinicia numa conversa nova na mesma aba. A primeira mensagem, seguida do caminho do arquivo de passagem, é enviada no seu lugar, e o agente retoma o trabalho de onde parou.

Janela Hand over and restart do AgentsRoom: o agente vai escrever as notas de passagem num arquivo do projeto e depois recomeçar na mesma aba, um campo First message of the next conversation preenchido com Read your handover and continue, e os botões Cancel e Hand over and restart
Uma única confirmação. A primeira mensagem da próxima conversa fica salva para este agente, e o agente acrescenta o caminho do seu arquivo de passagem.

Passagem, /compact ou /clear?

/clear joga fora a conversa inteira. É a ferramenta certa quando a tarefa terminou e a seguinte não tem nada a ver com ela, e a errada no meio de uma tarefa, porque tudo o que o agente sabia vai junto.

/compact substitui a conversa por um resumo que a CLI escreve, na mesma sessão. Você não escolhe o que sobrevive, o resumo só existe no contexto, e uma sessão longa compactada várias vezes guarda o resumo de um resumo.

Passar o trabalho e reiniciar fica entre os dois. O agente escreve as próprias notas de passagem, num arquivo que você pode ler e corrigir, e a nova conversa começa sem mais nada no contexto. É o gesto certo para uma tarefa que não terminou, mas cujo contexto está desgastado. O que o agente não anota vai embora com a conversa antiga, então vale dar uma olhada no arquivo quando há muita coisa em jogo.

Limites

  • O agente precisa das ferramentas do AgentsRoom (MCP) para reiniciar sozinho. Uma CLI que não as carrega não consegue, e a ação diz para você digitar /clear no lugar.
  • O reinício espera o fim do turno do agente. Se o agente estiver ocupado e a ação disser que ele não pode reiniciar agora, tente de novo depois que ele responder.
  • Ele é recusado, com uma mensagem que diz o motivo, para um passo de um Agent Team em execução, durante um teste de QA e enquanto os terminais do projeto estão sendo mostrados em outra janela: traga-os de volta para a janela principal primeiro.
  • Um reinício a cada 2 minutos e 6 por hora por agente, para que uma rotina presa num loop não possa reiniciar um agente sem parar.
  • A entrada só aparece para um agente que está rodando neste computador: não para um agente que roda em outra máquina da sua conta, nem para o assistente do projeto.
  • Tudo o que o agente não escreve nas notas de passagem se perde com a conversa antiga.

Perguntas frequentes

Faça outra pergunta
Como dar um contexto novo a um agente do Claude Code sem perder o progresso dele?
Clique com o botão direito no agente no AgentsRoom e escolha Passar o trabalho e reiniciar. O agente escreve as notas de passagem num arquivo do projeto, depois o console dele reinicia numa conversa nova que começa lendo esse arquivo. Você não digita /clear nem cola nenhum prompt, e a mesma ação funciona no Codex e nas outras CLIs de agente que carregam as ferramentas do AgentsRoom.
Qual é a diferença em relação ao /compact?
O /compact pede à CLI que substitua a conversa pelo próprio resumo, na mesma sessão, e você não escolhe o que sobrevive. Passar o trabalho e reiniciar faz o agente escrever as notas de passagem num arquivo que você pode ler, e depois inicia uma conversa limpa que as lê. Use o /compact para seguir rápido, e a passagem quando o contexto está desgastado e você quer controlar o que passa de uma conversa para a outra.
Para onde vai o arquivo de passagem?
Para o projeto. O agente usa o próprio arquivo de passagem, se a rotina dele mantém um, senão .handoff/latest.md, e o caminho é acrescentado à primeira mensagem da nova conversa. Ele fica no disco depois do reinício, então você pode abri-lo, corrigi-lo ou indicá-lo a outro agente.
Posso mudar a primeira mensagem da nova conversa?
Sim. A janela tem um campo Primeira mensagem da próxima conversa, "Read your handover and continue" por padrão. O que você digitar ali fica salvo para esse agente e acompanha você em todos os computadores da sua conta e no celular. Deixe o campo vazio para voltar à mensagem padrão.
Um agente pode passar o trabalho e reiniciar sozinho?
Um agente pode reiniciar o próprio console com a ferramenta agents_restart das ferramentas do AgentsRoom, por exemplo a partir de uma rotina que grava um ponto de retomada quando o contexto fica cheio demais. O agente coordenador de um projeto também pode pedir uma passagem para um colega de equipe, mas só você pode aprová-la: a janela mostra quem pede e por quê, e o coordenador não fica sabendo da sua escolha.
Funciona com o Codex e as outras CLIs?
Sim, com qualquer CLI de agente que carregue as ferramentas do AgentsRoom, porque o reinício passa por essas ferramentas e não por um comando próprio de uma CLI. Quando uma CLI não as carrega, a ação avisa e você mesmo pode digitar /clear no console dela.
Por que o app diz que o agente não pode reiniciar agora?
A mensagem dá o motivo. Talvez o agente esteja no meio de um turno: espere a resposta dele. Talvez seja um passo de um Agent Team em execução ou de um teste de QA, que são recusados. Talvez os terminais dele estejam sendo mostrados em outra janela: traga-os de volta para a janela principal. Ou ele atingiu o limite de um reinício a cada 2 minutos e 6 por hora.

Para se aprofundar

Você também pode gostar

Engenheiro de DevOpsRedatorDesenvolvedor FrontendRepresentante ComercialDesenvolvedor BackendCoach e FormadorArquiteto de SoftwareConsultor JurídicoEngenheiro de QAFinanças e AdministraçãoDesenvolvedor Full-StackDesigner CriativoDesenvolvedor MobileInvestigadorEngenheiro de SegurançaRH e Recrutamento
Gerente de ProjetosTradutorEspecialista em GitAnalista de DadosEspecialista em SEOContabilistaEspecialista em LocalizaçãoComunicação e RPGerador de IdeiasOperações e LogísticaEspecialista em MarketingApoio ao ClienteAssistente do projetoCompradorCommunity ManagerAssistente Pessoal

Dê aos seus agentes um recomeço que se lembra

Passar o trabalho e reiniciar está no AgentsRoom para macOS, Windows e Linux, com download gratuito.

Baixar AgentsRoomGrátis

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Agentes que você lê como uma conversa

Cada agente tem uma função, um rosto e um fio que você lê como um app de mensagens.

Visão de conversa

Visão de conversa do AgentsRoom: o trabalho de um agente de programação com IA em formato de chat
Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades