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. Use Filtrar sessões, ao lado do campo de busca, para restringir a lista por Status, Projeto, Ambiente ou Quando. Um ponto marca uma sessão que terminou ou falhou enquanto você estava fora, até você abri-la, e um lápis marca uma sessão com um rascunho não enviado. Clique no cabeçalho de um projeto para recolher o grupo; Arquivadas começa recolhido. Para agir sobre várias sessões de uma vez, clique nelas com Shift ou Cmd (Ctrl no Windows e no Linux) e depois fixe, arquive ou exclua todas pela barra de seleção. As conversas aceitam a mesma seleção para exclusão. O menu … de um projeto permite fixá-lo, iniciar uma nova sessão na pasta, arquivar suas sessões ou removê-lo da barra lateral. Remover um projeto apenas o oculta neste computador; nenhuma sessão ou arquivo é excluído. 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. Quando um turno termina, o compositor pode sugerir, em texto esmaecido, a mensagem que você provavelmente enviará a seguir. PressioneTab para aceitá-la e envie como de costume; digitar qualquer outra coisa a oculta. Ative ou desative as sugestões em Ajustes → Compositor → Sugerir um próximo prompt.
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. Para alterar uma mensagem que você enfileirou pelo compositor, use os botões abaixo dela antes do envio: Editar mensagem a devolve ao compositor, que precisa estar vazio, e Remover da fila a exclui. PressionarUp em um compositor vazio também recupera a última mensagem da fila.
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.
Faça uma pergunta paralela
Para perguntar sobre uma sessão local sem interrompê-la, escolha Conversa paralela no cabeçalho da sessão ou pressioneCmd + Shift + A (Ctrl + Shift + A no Windows e no Linux). Você também pode digitar /ask seguido da pergunta no compositor principal, ou selecionar um trecho da sessão, clicar com o botão direito e escolher Perguntar sobre isto.
A conversa paralela lê a conversa da sessão e pode ler arquivos, mas não edita arquivos nem executa comandos. Nada nela chega ao agente, a menos que você copie uma resposta para o compositor principal e a envie. Fechar uma conversa paralela a exclui.
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. Para guardar uma cópia fora do aplicativo, abra o menu de uma sessão ou conversa na barra lateral e escolha Exportar como Markdown… ou Copiar como Markdown. Para a sessão ou conversa aberta, pressioneCmd + Shift + S (Ctrl + Shift + S no Windows e no Linux). Arquivo → Importar de Markdown… lê uma exportação de volta: uma conversa se torna uma conversa que você pode continuar, e uma sessão abre como um novo rascunho, com a exportação anexada.
Retome uma decisão
Fixe uma mensagem útil e abra Fixados para encontrá-la depois. Para explorar outra abordagem, escolha Ramificar a partir daqui em uma resposta depois que a execução terminar. Isso copia a conversa até aquele ponto para uma nova sessão e mantém a original inalterada. 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.