Trabalhando com várias GitHub Copilot CLI sessões

Introdução

Sempre que você iniciar Copilot CLI, você iniciará ou retomará uma sessão. Você pode pensar em uma sessão como uma conversa entre você e GitHub Copilot, o que inclui:

Seus prompts: o que você pediu que Copilot fizesse e todas as respostas que você deu quando Copilot fez perguntas a você.
CopilotRespostas: respostas, explicações, comandos, alterações de código e assim por diante.
Contexto da conversa: informações enviadas para o modelo de linguagem grande para permitir que ele responda aos seus prompts adequadamente.
Atividade da ferramenta: os arquivos Copilot foram acessados, os comandos executados, as pesquisas que ele executou.
Estado específico da sessão: por exemplo, o diretório de trabalho atual, as permissões do sistema de arquivos, as aprovações de acesso, o modo atual (interativo, plano ou piloto automático).

Você não está limitado a uma sessão de cada vez. Você pode manter vários em execução lado a lado e alternar entre eles. Isso pode ser útil quando você:

Trabalhando em duas partes de trabalho de uma só vez , por exemplo, criando um recurso em uma sessão enquanto corrigi um bug não relacionado em outra.
Esperando a conclusão de uma tarefa demorada, deixe uma sessão compilar, executar sua suíte de testes ou funcionar de forma autônoma em piloto automático enquanto você planeja a próxima alteração em outra.
Transferir uma tarefa — delegue uma tarefa à nuvem e fique de olho nela enquanto continua trabalhando localmente.

Há três locais onde você pode trabalhar com suas sessões:

A barra lateral de sessões: um painel acoplado à esquerda da conversa atual para alternar rapidamente entre sessões. Essa é a maneira mais rápida de se mover entre sessões locais ativas ou recentemente ativas.
A aba Sessões: uma lista mais completa do seu histórico de sessões, incluindo sessões remotas. A lista é pesquisável e é exibida na área principal da CLI.
O seletor de sessão: uma interface de linha de comando para alternar entre sessões, que você pode invocar de qualquer sessão local inserindo /resume ou /continue.

A barra lateral das sessões é o foco principal deste artigo.

A barra lateral é um painel que se abre ao lado da sua conversa atual. Como ele fica ao lado da conversa em vez de substituí-la, a linha do tempo da conversa e o campo de entrada do prompt permanecem visíveis enquanto você está na guia Atual da área da CLI principal. Você pode ver suas outras sessões sem sair da sessão em que está trabalhando.

Na conversa, quando não houver nada no campo de entrada do prompt, pressione ← para abrir a barra lateral e mover o foco para ela. Pressione → para mover o foco de volta para a conversa e, novamente, para fechar a barra lateral. Se você preferir chaves estilo Vim, h e l funcionam da mesma maneira enquanto a barra lateral tem foco.

Alternando entre sessões

Enquanto a barra lateral tem foco, pressione ↑ e ↓ (ou k e j) para percorrer suas sessões. Pressione Enter para abrir a sessão escolhida. O foco volta para a conversa, permitindo que você digite imediatamente um prompt.

Pressione s para alterar a ordem na qual as sessões são listadas, passando por Recentes, Criadas, Nome e Nenhuma (não classificadas).

Você também pode alternar para uma sessão com o mouse. Tanto um clique simples quanto um clique duplo alternam para uma sessão. Um único clique retorna o foco para a conversa (como pressionar Enter), enquanto um clique duplo deixa o foco na barra lateral com essa sessão selecionada, para que você possa continuar movendo-se pela lista de sessões.

Criando e fechando sessões

Você pode gerenciar suas sessões diretamente da barra lateral:

Pressione n para iniciar uma nova sessão.
Pressione x duas vezes para fechar a sessão realçada.

Observação

Sessões em execução são encerradas, salvas e removidas da barra lateral. As sessões que não estão em execução são simplesmente removidas da barra lateral. As sessões removidas dessa forma não são exibidas na barra lateral em sessões futuras, a menos que você retome a sessão, por exemplo, do >/resume seletor de sessão.

Na parte superior da barra lateral estão dois botões de cabeçalho: ← (para fechar a barra lateral) e + (para iniciar uma nova sessão). Pressione ↑ depois da parte superior da lista para passar para essa linha de botão e, em seguida, Tab para alternar entre os botões e Enter para ativar um. Você também pode clicar em um botão diretamente.

Lendo o status da sessão rapidamente

Como a barra lateral permanece na tela enquanto você trabalha, ela atua como um quadro de status de sessão. Você pode dizer rapidamente quais sessões são:

Atualmente em execução (um ícone de círculo sólido: ●).
A sessão atual exibida na guia Atual da CLI (realçada).
Usado recentemente, mas não em execução no momento (um ícone de círculo oco: ○).
Ocupado processando uma curva (um ícone de círculo pulsante: ● ◉ ◎ ○) ou ocioso (um ícone estático).
Aguardando sua atenção (! para um prompt de permissão, ? para uma pergunta).
Em um modo específico (os modos de plano e piloto automático usam texto colorido diferente do modo padrão).

Redimensionamento e controle do mouse

Além de clicar em uma sessão para mudar para ela, você pode arrastar o divisor entre a barra lateral e sua conversa para redimensionar o painel, além de passar o cursor sobre a lista e usar a roda do mouse para percorrer listas mais longas de sessões.

Obtendo ajuda rápida

Pressione ? enquanto a barra lateral está aberta para ver um guia de referência rápida para a barra lateral da sessão.

Para obter a referência da barra lateral completa, consulte referência de comando da CLI GitHub Copilot.

A aba Sessões

A guia Sessões é uma visualização em tela cheia das suas sessões. Use a tecla Tab para alternar para essa guia. Como alternativa, insira /session.

A guia Sessões oferece várias coisas que você não obtém na barra lateral:

Pesquisa: pressione / e comece a digitar o nome de uma sessão que você deseja localizar.
Filtro de escopo: pressione a para percorrer a lista entre as sessões locais, remotas e todas as sessões.
Histórico completo: a aba analisa todo o seu armazenamento de sessões, não apenas as sessões recentes.
Sessões de nuvem e remotas: as sessões executadas na nuvem aparecem aqui para que você possa retomá-las.

Ambos os lugares listam suas sessões, mas foram ajustados para finalidades diferentes. A barra lateral é um alternador rápido para as sessões que você está gerenciando ao mesmo tempo. A aba Sessões é a biblioteca completa e a área de gerenciamento.

	Barra lateral	Aba Sessões
Layout	Fixado ao lado da sua conversa	Tela cheia
Seu chat atual	Permanece visível	Oculto enquanto a guia está aberta
Sessões mostradas	Sessões locais recentes e ao vivo	Seu histórico completo
Sessões de nuvem/remotas	No	Sim
Pesquisar	No	Sim
Escopo (todos/locais/remotos)	Não (apenas local)	Sim
Mais adequado para	Alternar rapidamente no contexto	Localizando, navegando e gerenciando

Use a barra lateral quando quiser:

Permaneça na conversa. A barra lateral mantém a linha do tempo da conversa na tela enquanto você vê suas outras sessões. Abrir a guia Sessões oculta totalmente a conversa atual.
Troque rapidamente, no mesmo lugar. Com a barra lateral focada, você pode alternar rapidamente entre as sessões.
Fique de olho no status. Como ela permanece na tela, a barra lateral permite que você veja o status e os marcadores de atenção das suas sessões, sem precisar sair da tela para verificá-los.
Alterne sem sair do seu fluxo. Você pode abrir, fechar, alternar sessões com as teclas de direção como parte da digitação normal.

Use a aba Sessões quando quiser:

Pesquise por uma sessão anterior específica.
Retome uma sessão na nuvem ou remota — essas sessões só aparecem na aba.
Navegue pelo histórico completo— as sessões mais antigas que saíram da lista recente da barra lateral só podem ser acessada aqui.

Você não abre mão de muita coisa ao permanecer na barra lateral no trabalho do dia a dia. Você pode fazer a maioria do gerenciamento de sessão na barra lateral sem acessar a guia Sessões .

Retornando a uma sessão anterior

As sessões são salvas, portanto, você pode voltar ao trabalho iniciado anteriormente para continuar uma tarefa, verificar o que um agente fez ou reutilizar o contexto que você já havia criado.

Na barra lateral: as sessões recentes do seu diretório atual aparecem como itens que podem ser retomados (marcados com ○). Realce um e pressione Enter para abri-lo e começar a trabalhar lá novamente.
Na guia Sessões: pesquise ou navegue pelo histórico completo, incluindo sessões de nuvem, e abra qualquer uma delas.
Com o seletor de sessão: em uma sessão local, insira /resume (ou /continue) para exibir um seletor listando suas sessões salvas. Use as teclas de direção para navegar até uma sessão e pressione Enter para abri-la ou d excluí-la. Pressione s para percorrer diferentes ordens de classificação para a lista: relevância (quão bem ele corresponde ao diretório de trabalho atual), usado pela última vez, criado e nome.

Você também pode escolher uma sessão ao iniciar Copilot CLI na linha de comando:

# Resume the most recent session
copilot --continue

# Choose a session to resume
copilot --resume

# Resume a specific session by ID, ID prefix, or exact name
copilot --resume=SESSION-ID
copilot --resume="my feature"

# Name a new session so it is easy to find later
copilot --name "checkout refactor"

Sessões ativas e inativas

A qualquer momento, uma sessão é uma das duas coisas:

Ativo: em execução agora dentro Copilot CLI, seja a sessão com a qual você está conversando ou uma em execução em segundo plano. Quando você se afasta de uma sessão, ela continua em execução em vez de parar, de modo que uma tarefa longa continua enquanto você se move para outra. As sessões ativas são indicadas com um círculo preenchido (●).
Inativo: salvo em disco, mas não em execução. Sessões inativas são indicadas com um círculo vazio (○).

Uma sessão local permanece ativa enquanto o processo Copilot CLI que a executa continuar aberto. Não há tempo limite de inatividade– uma sessão em segundo plano ociosa não é interrompida automaticamente. Ao fechar Copilot CLI, suas sessões locais são interrompidas e ficam inativas. Eles ainda estão salvos, para que você possa retomá-los da próxima vez. Para impedir que o computador entre em suspensão enquanto uma sessão estiver ativa, use /keep-alive on.

As sessões também podem ser executadas remotamente. Quando você delega uma tarefa com /delegate (ou ao prefixar um prompt com &), Copilot encaminha o trabalho para Copilot cloud agent em GitHub, que funciona em segundo plano em seu nome — independentemente do seu CLI. Essas sessões de nuvem aparecem na guia Sessões , em que você pode retomá-las e orientar localmente. Para saber mais sobre o trabalho sem intervenção manual, consulte Delegando tarefas para Copilot.

Interrompendo uma sessão

Para encerrar a sessão na qual você está trabalhando no momento, use o comando de barra /exit. Como alternativa, você pode interromper uma sessão da barra lateral realçando-a e pressionando x. Isso interrompe a sessão e a remove da barra lateral até que você a retome.

Parar uma sessão não a exclui. A sessão é salva e você pode retomá-la mais tarde.

Você não precisa parar as sessões. Deixá-los em execução permite que você volte para eles instantaneamente com todo o contexto. Mas você pode parar uma sessão para interromper um trabalho que você não quer mais: por exemplo, uma sessão em modo piloto automático ou uma sessão executando um prompt que você agendou com /every ou /after. Você também pode optar por interromper uma sessão para liberar memória ou apenas para reduzir a desordem na barra lateral.

Comandos de barra de sessão

Você pode gerenciar sessões com comandos com barra em qualquer sessão:

Command	O que faz
`/new`	Inicie uma nova sessão.
`/resume [SESSION-ID]`, `/continue`	Alterne para outra sessão, escolhendo no seletor (ou passe uma ID).
`/rename [NAME]`	Renomeie a sessão atual (um nome será gerado se você omitir um).
`/session`	Abra a guia Sessões .
`/session info`	Mostrar detalhes sobre a sessão atual.
`/session id`	Mostrar a ID da sessão atual e copiá-la para a área de transferência.
`/session files`	Liste os arquivos alterados nesta sessão.
`/session plan`	Mostrar o plano atual.
`/session checkpoints [N]`	Mostrar os pontos de verificação da sessão.
`/session cleanup`, `/session prune`	Limpeza de dados de sessão antigos ou expirados.
`/session delete [ID]`, `/session delete-all`	Exclua uma sessão ou todas elas.
`/exit`, `/quit`	Feche a sessão atual. Se outros estiverem abertos, o mais recente entre os restantes passará para o primeiro plano. A CLI é encerrada somente quando você fecha a última sessão.

A barra lateral está disponível por padrão. Você pode desativar a possibilidade de abri-lo ou alterar vários aspectos do seu comportamento, por meio dos vários comandos de barra /settings sidebar.* em uma sessão interativa. Por exemplo, você pode habilitar botões de fechamento para cada sessão na barra lateral e pode fazer com que o foco atual (conversa ou barra lateral) siga a posição do ponteiro do mouse.

Para obter a lista completa de configurações da barra lateral e seus padrões, consulte referência de comando da CLI GitHub Copilot.

Leitura adicional: