Usando dados de sessão CLI do GitHub Copilot

CLI do Copilot armazena os dados das suas sessões de CLI localmente na sua máquina. 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 perguntas a Copilot sobre suas interações anteriores.

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 dados de sessão do 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.
  

Ao retomar uma sessão, Copilot carrega todo o histórico 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 em GitHub.com. Isso permite que você compartilhe suas instruções e as respostas de Copilot com outras pessoas, ou armazene 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 breve relatório com base nas suas sessões CLI do Copilot, por padrão das últimas 24 horas. Copilot analisa em quais ramificações você trabalhou, o que você realizou e quaisquer GitHub solicitações de pull ou problemas que você tenha mencionado. 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 definir Copilot para usar um intervalo de tempo diferente, em vez do padrão das últimas 24 horas:

/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 utiliza CLI do Copilot. Em seguida, ele fornece 3 a 5 recomendações personalizadas. Copilot analisa suas solicitações reais, as ferramentas que você usa e os recursos que você ainda não experimentou. 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 analisa detalhadamente o histórico da sua sessão para identificar momentos em que Copilot teve dificuldade em fornecer o tipo de resposta ou resultado que você esperava, ou em que você precisou corrigir o rumo fornecendo prompts complementares. Com base nesta pesquisa, ele sugere melhorias no arquivo .github/copilot-instructions.md de instruções personalizadas.

Registrar conhecimentos específicos do projeto como instruções personalizadas é uma forma eficaz de melhorar o desempenho de Copilot ao trabalhar no seu projeto. Para obter mais informações, consulte Using GitHub Copilot CLI session data.

Copilot procura sinais de atrito — falhas repetidas nos testes, erros de compilação que exigiram várias tentativas, mensagens de usuários que corrigiram ou redirecionaram o agente e padrões que se repetem ao longo das 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 constatar que tentou repetidamente usar jest no seu projeto que utiliza vitest, ou que continuou gerando importações em um estilo que não corresponde às convenções do seu código-fonte. 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 cria ou atualiza o arquivo .github/copilot-instructions.md.

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 utilizará automaticamente o armazenamento de sessão para fornecer o contexto da 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, procurando momentos em que uma resposta inicial não foi seguida por solicitações relacionadas e momentos em que houve uma série de solicitações 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 analisará seus padrões de sessão — duração das solicitações, número de etapas de continuação e frequência de uso da ferramenta — e sugerirá maneiras de alcançar 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 registros de data e hora da sessão e os resultados 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 utiliza a pesquisa de texto completo no histórico de suas sessões 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)