Criar e navegar entre sessões

Abrir um shell

1. Abra a tela Terminal do projeto.
2. Na barra de abas, use o botão de nova aba.
3. No Windows, o mesmo menu oferece o shell: PowerShell, CMD Prompt, Git Bash ou WSL. Em macOS e Linux, a aba nova usa o shell padrão da máquina.

A sessão nasce no diretório de trabalho do projeto e passa a ser uma aba da tela Terminal.

Abrir um agente

Uma CLI de agente é uma sessão como qualquer outra: ela roda no painel, com histórico, busca e restauração iguais às de um shell.

Se você já sabe qual agente quer, criar a sessão já com o agente é melhor do que abrir um shell e digitar o comando: a sessão nasce com o processo certo, sem uma janela em que um shell está no controle.

O que esperar: o agente ainda está subindo quando a criação termina. Escrever nele nesse instante chega embaralhado — o texto cai no shell antes de a interface do agente assumir. Espere o agente ficar ocioso antes de enviar a primeira mensagem; o passo a passo está em Trabalhar com um agente no Terminal.

Alternar entre abas

• Clique na aba para ativá-la.
• Quando há abas fora da área visível, a barra de abas rola: use as setas nas pontas para alcançá-las.
• Trocar de aba não interrompe o que está rodando nas outras.

Descobrir o que está aberto

Além da própria barra de abas, existe a listagem de sessões, útil quando há muitas abas, quando você quer o identificador de uma sessão ou quando a sessão está em outro workspace.

O que a listagem devolve:

• uma entrada por sessão viva, com título, identificador e o workspace a que pertence;
• totalCount — quantas sessões existem de fato;
• truncated — se a lista que você recebeu está cortada, por paginação ou pelo teto interno do servidor.

Leia truncated antes de concluir que a lista está completa. A listagem tem um teto interno de segurança; paginar só muda o que é exibido, não o teto.

Sessões criadas a partir de um cartão do Canvas podem demorar alguns segundos para aparecer na listagem.

Detalhes e troca de foco

• Detalhar uma sessão devolve metadados e uma prévia do que está na tela, sem encerrar nem escrever nada no processo.
• Trocar para uma sessão muda a aba visível — o mesmo efeito de clicar na aba. Não muda o que está rodando.

Por linha de comando

Para criar, listar, detalhar e trocar de aba sem sair do terminal, veja Referência de comandos do Terminal — os comandos de criação, listagem, detalhe e troca, com as opções de seleção de workspace e paginação.

Se algo não funcionar

• A sessão não aparece na listagem: confira o workspace da consulta e o campo truncated; sessões de cartão do Canvas demoram alguns segundos.
• O agente recebeu texto embaralhado: você escreveu antes de a interface dele assumir. Use Ler, enviar e esperar para esperar a condição certa antes de escrever.
• O painel não abre: siga Quando o terminal não abre.