Inicie e organize uma sessão
Abra Código → Nova sessão, escolha uma pasta e confira branch, modelo e permissões antes da primeira mensagem. Essa mensagem vincula o ambiente à sessão. Para trabalhar em outro ambiente de execução, crie uma sessão e escolha o destino primeiro. Dê a cada sessão um objetivo específico, como investigar um teste de checkout ou revisar uma mudança de API. Use o menu da sessão para renomear, fixar trabalhos frequentes ou arquivar o que terminou. Sessões arquivadas continuam em Arquivadas. Excluir uma sessão local remove seu histórico deste computador; leia a confirmação antes de continuar. Uma conversa nova não cria outra cópia do repositório. Se duas tarefas precisarem editar o projeto de forma independente, use worktrees separados.Adicione contexto do projeto
Mencione caminhos de arquivos com@ ou anexe a saída do teste que falhou. O campo de mensagem aceita seleção de arquivos, arrastar e soltar e anexos colados, incluindo especificações e capturas de tela. O envio de imagens exige um modelo que aceite esse tipo de entrada.
Faça uma solicitação verificável
Inclua comportamento observado, resultado esperado e como verificá-lo. Nomes de arquivos e saída do erro ajudam o agente a começar pelo código relevante:O checkout retorna 12 para três itens com preço 12. Leia @checkout.js e @checkout.test.js. Adicione um teste que falhe esperando total 36, corrija o cálculo e execute npm test. Preserve a assinatura pública da função.Selecione o item correto nas sugestões de
@ antes de enviar. Anexe um design ou captura quando a aparência importar e explique a região relevante. Alguns documentos exigem uma skill; o aplicativo avisa quando ela está inativa.
Na miniatura da captura, abra a opção de marcação da imagem para destacar um controle ou região. Revise o resultado e escolha Aplicar. A imagem marcada substitui o anexo dessa mensagem.
Acompanhe uma tarefa em execução
A linha do tempo registra as respostas e a atividade das ferramentas durante a tarefa. Cada cartão mostra uma ação e seu resultado: leitura de arquivo, execução de comando ou resposta de um serviço conectado. No exemplo da compra, examine primeiro a falha do teste e compare-a com o resultado após a mudança no cálculo. Clique no cartão para expandir o comando e sua saída. Quando o aplicativo pedir aprovação, examine a ação proposta antes de aprová-la ou negá-la. Responda às perguntas do agente na sessão e envie novas instruções se precisar mudar o rumo da tarefa. O envio de mensagens durante uma execução segue Ajustes → Compositor → Mensagem durante uma execução. Enfileirar guarda a mensagem até a execução terminar. Interromper a entrega na próxima interação com o modelo, permitindo mudar a ação seguinte do agente. Para encerrar a execução ativa, escolha Cancelar a execução.Enfileire, redirecione ou pare
Use Enfileirar quando a mensagem depender do resultado atual, como um resumo após os testes. Use Interromper para mudar a próxima ação, por exemplo corrigindo um nome de arquivo ou reduzindo o escopo. A interrupção chega na próxima interação com o modelo; confira na linha do tempo o que já foi executado. Cancelar para o turno ativo. Depois, confira as alterações da sessão para saber quais edições permaneceram e decidir como continuar. Cancelar não reverte arquivos pelo Git.Retome um trabalho anterior
Para retomar um trabalho, use Buscar sessões para localizar uma sessão pelo nome ou pelo texto da conversa. Selecione-a para reabrir a conversa e continuar no ambiente salvo. Use Buscar nesta sessão para encontrar um resultado em um histórico longo.Retome uma decisão
Fixe uma mensagem útil e abra Fixados para encontrá-la depois. Quando a opção de criar uma ramificação a partir da mensagem estiver disponível, use-a para explorar outra abordagem em uma conversa separada. Isso ramifica a discussão; use uma branch Git ou worktree se os arquivos também precisarem de isolamento. Reiniciar a partir desta mensagem e a opção de editar e reiniciar substituem a conversa posterior. A confirmação pode oferecer restaurar arquivos alterados desde aquele ponto. Confira a lista: manter a transcrição, substituir mensagens e restaurar arquivos são operações diferentes.A busca encontra sessões anteriores para retomar a conversa e consultar seus resultados.