Usando CLI do GitHub Copilot dados de sessão

          CLI do Copilot armazena os dados de suas sessões da CLI localmente em seu computador. Esses dados de sessão permitem que você:

• Retome as sessões anteriores e continue de onde parou.
• Use o comando de barra /chronicle para gerar relatórios rápidos, obter dicas personalizadas e receber sugestões para melhorar seu arquivo .github/copilot-instructions.md.
• Faça Copilot perguntas sobre suas interações passadas.

Este artigo explica como usar esses recursos. Para obter um aprofundamento sobre como os dados de sessão são armazenados e os benefícios do /chronicle comando, consulte Sobre os dados de sessão CLI do GitHub Copilot.

Retomando uma sessão anterior

Você pode retomar uma sessão interativa anterior da Interface de Linha de Comando (CLI) tanto da linha de comando quanto durante uma sessão ativa.

•         **Na linha de comando**, execute `copilot --continue` para retomar sua sessão mais recente. Se você quiser escolher entre uma lista de sessões recentes, execute `copilot --resume` para abrir um seletor de sessão que lista suas sessões recentes. Como alternativa, se você souber a ID da sessão que deseja retomar, poderá correr `copilot --resume SESSION-ID` para ir direto para ela.
  

•         **Durante uma sessão interativa, digite**`/resume` para alternar para uma sessão diferente. É exibido um seletor que mostra suas sessões recentes. Como alternativa, você pode entrar `/resume SESSION-ID` para ir direto para uma sessão específica.
  

Quando você retoma uma sessão, Copilot carrega o histórico completo da conversa, para que você possa continuar exatamente de onde parou.

Renomeando uma sessão

Quando você usa a opção --resume de linha de comando ou o /resume comando barra, suas sessões recentes são listadas. A coluna final da lista mostra o nome da sessão, o que ajuda a identificar a sessão que você deseja retomar. Se você tiver uma sessão para a qual retorna com frequência, talvez queira dar a ela um nome personalizado para facilitar a localização na lista.

Para renomear uma sessão:

1. Em uma sessão interativa, se você quiser renomear uma sessão diferente da sessão atual, use o /resume comando barra para alternar para a sessão que deseja renomear.

2. Digite /rename NEW_NAME para renomear a sessão atual. Você não precisa colocar o nome entre aspas.

   Por exemplo, /rename Improve test coverage.

Compartilhar uma sessão

Você pode salvar o conteúdo da sessão atual como um arquivo Markdown ou um gist privado.GitHub.com Isso permite que você compartilhe seus prompts e Copilot respostas com outras pessoas ou mantenha um registro do seu trabalho fora da CLI.

Para compartilhar uma sessão como um gist, digite o seguinte em uma sessão interativa:

/share gist

/share gist

Para exportar a conversa de sessão como um arquivo Markdown, digite:

/share file [PATH-TO-FILE]

/share file [PATH-TO-FILE]

Se você não especificar um caminho de arquivo, o arquivo Markdown será salvo no diretório de trabalho atual com o nome copilot-session-SESSIONID.md.

Usar o comando barra /chronicle

O comando de barra /chronicle fornece um conjunto de subcomandos que geram insights específicos do histórico de sessão. Embora você possa fazer Copilot perguntas de forma livre sobre suas sessões a qualquer momento, /chronicle os subcomandos fornecem uma maneira rápida de obter insights específicos.

Quando você digita /chronicle sem argumentos, um seletor é exibido que permite escolher entre os subcomandos disponíveis:

Você também pode invocar um subcomando diretamente, sem usar o seletor, por exemplo, /chronicle standup.

/chronicle standup

Isso gera um relatório breve baseado nas suas CLI do Copilot sessões das últimas 24 horas, por padrão. O Copilot analisa em quais ramificações você trabalhou, o que você realizou e quaisquer pull requests ou issues do GitHub que você tenha referenciado. Ele agrupa os resultados por status de conclusão, com cada item identificado por sua ramificação, e verifica o status atual de quaisquer solicitações de pull vinculadas.

Exemplo de resumo rápido

Standup for March 13 2026:

✅ Done

myapp-repo repo maintenance (main branch)

 - Synced local, cleaned files, audited deps, reviewed architecture
 - Session: 69a027e4-9b7b-493e-922e-107acd25abab

🚧 In Progress

MyApp configuration (suppress-start-message branch, myapp-repo)

 - Suppressing startup init prompt message
 - Session: 3034d813-3e1f-413a-b3d9-15427ef8c19c

Você pode acrescentar contexto adicional ao comando para personalizar a saída. Por exemplo, você pode dizer Copilot para usar um período de tempo diferente, em vez das últimas 24 horas padrão:

/chronicle standup for the last 3 days

/chronicle standup for the last 3 days

/chronicle tips

Isso analisa suas sessões recentes para entender como você trabalha e como você usa CLI do Copilot. Em seguida, ele fornece 3 a 5 recomendações personalizadas. Copilot examina suas solicitações reais, as ferramentas que você usa e os recursos que você ainda não explorou. Ele faz referência cruzada a isso com o conjunto completo de recursos da CLI disponíveis, incluindo quaisquer agentes e habilidades personalizados que você configurou no repositório, para encontrar oportunidades que você possa estar perdendo.

As dicas são fundamentadas em seus dados de uso reais, fornecendo sugestões específicas em vez de conselhos genéricos.

Dicas de exemplo

Veja a seguir um exemplo dos principais pontos de uma /chronicle tips resposta. Em uma resposta real, cada ponto é explicado com mais detalhes.

1. Use @ to mention files instead of pasting content
2. Iterate within a session — don't start over
3. Try /research for your exploration work
4. Turn recurring prompts into a custom agent
5. Use plan mode for multi-step work

Você pode concentrar as dicas em uma área específica acrescentando o contexto após /chronicle tips. Por exemplo:

/chronicle tips for better prompting

/chronicle tips for better prompting

/chronicle improve

Isso faz uma análise aprofundada do seu histórico de sessões para identificar locais em que o Copilot teve dificuldade em fornecer o tipo de resposta ou resultados que você esperava, ou em que foi necessário ajustar o rumo por meio de prompts de acompanhamento. Com base nesta pesquisa, ele sugere melhorias no arquivo .github/copilot-instructions.md de instruções personalizadas.

Capturar o conhecimento específico do projeto como instruções personalizadas é uma maneira poderosa de melhorar o desempenho de Copilot no seu projeto. Para obter mais informações, consulte Adicionando instruções personalizadas para CLI do GitHub Copilot.

          Copilot procura sinais de atrito : falhas de teste repetidas, erros de build que exigiram várias tentativas, mensagens de usuário que corrigiram ou redirecionam o agente e padrões que se repetem entre as sessões. Em seguida, ele apresenta 3 a 5 recomendações específicas, cada uma explicando o problema encontrado e a instrução que o resolveria.

Por exemplo, Copilot pode achar que ele tentou usar jest repetidamente para seu projeto que usa vitestou que ele continuou gerando importações em um estilo que não corresponde às suas convenções de base de código. As instruções sugeridas evitariam esses erros em sessões futuras.

Depois de apresentar suas recomendações, Copilot pergunta quais você gostaria de aplicar. Por padrão, todas as recomendações são selecionadas, mas você pode usar as teclas de direção no teclado para ir para qualquer uma das recomendações e pressionar a barra de espaço para desativar a sugestão. Depois de escolher quais recomendações aplicar, pressione Enter. Copilot em seguida, cria ou atualiza o .github/copilot-instructions.md arquivo.

Fazer perguntas sobre seu histórico de sessão

Você não precisa usar um comando de barra para aproveitar o histórico da sessão. Se Copilot determinar que você está perguntando sobre o uso da CLI, ele usará automaticamente o repositório de sessão para fornecer o contexto para uma resposta.

Aqui estão alguns exemplos dos tipos de perguntas que você pode fazer:

Insights sobre tarefas

Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?

Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?

          Copilot analisará suas conversas, buscando momentos em que uma resposta inicial não foi seguida por prompts relacionados e momentos em que houve uma série de prompts e respostas iterativas.

Reduzir o uso de requisições premium

Based on my previous CLI sessions, how could I prompt you in a way that would cost less?

Based on my previous CLI sessions, how could I prompt you in a way that would cost less?

          Copilot examinará os padrões de sessão, o comprimento do prompt, o número de etapas de continuação e a frequência de chamadas de ferramenta, e sugerirá maneiras de obter os mesmos resultados com menos interações.

Encontrar seus tempos mais produtivos

Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?

Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?

          Copilot consultará os carimbos de data/hora e os resultados das sessões para identificar quando suas interações tendem a ser mais eficientes.

Revisar trabalhos anteriores

Have I worked on anything related to authentication in the last month?

Have I worked on anything related to authentication in the last month?

          Copilot usa a pesquisa de texto completo em todo o histórico de sessão para encontrar sessões relevantes e, em seguida, resume o que você fez.

Leitura adicional

•         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/chronicle)
  

•         [AUTOTITLE](/copilot/reference/cli-command-reference)