Sessões

Criar uma sessão#

Há várias formas de iniciar uma sessão, dependendo de quanto você quer configurar antes:

Botão +

Cria uma sessão numerada automaticamente logo após a ativa (no mesmo grupo) e abre o navegador de pastas para você escolher onde ela começa. Clique em Mover para cá ou feche o navegador para ficar na sua pasta pessoal. No Windows, o + pergunta primeiro se você quer iniciar o PowerShell ou o Prompt de Comando.

Seta de local ao lado do +

Passe o mouse sobre ela para escolher antes a pasta inicial: Início, seus favoritos ou Locais recentes.

Cmd/Ctrl+T

Abre o formulário detalhado: Nome da sessão, Grupo (opcional), Local, shell e uma Session note (optional).

Clique com o botão direito em um espaço vazio da barra lateral

Criar sessão adiciona uma nova sessão de nível superior.

Pelo navegador de pastas

Nova sessão no navegador de pastas de qualquer painel abre uma sessão na pasta que você está vendo.

Pelo Finder (macOS)

Clique com o botão direito em uma pasta → Ações Rápidas → Abrir no PATerminal, use Abrir com ou solte uma pasta sobre o ícone do Dock. Veja Configurações.

Alternar entre sessões#

• Clique em uma sessão na barra lateral.
• Ctrl+Tab / Ctrl+Shift+Tab avançam e voltam pelas sessões — funciona mesmo com o cursor dentro de um terminal.
• ⌘⇧↓ / ⌘⇧↑ (Windows: Ctrl+Shift+↓ / Ctrl+Shift+↑) descem e sobem seguindo a ordem da barra lateral.
• Cmd/Ctrl+1 … Cmd/Ctrl+9 vão direto para as nove primeiras sessões.

As sessões que você não está vendo continuam rodando. A saída delas fica em buffer de forma nativa, então nem uma dúzia de agentes ocupados deixa a sua digitação lenta.

Status da sessão#

Cada linha de sessão mostra o que os terminais dela estão fazendo:

Executando

Algo está gerando saída ou trabalhando depois do que você digitou.

Aguardando entrada

Um agente está pedindo algo a você — uma aprovação, uma escolha ou uma resposta.

Concluído

O trabalho terminou. Se terminou enquanto você estava em outro lugar, a sessão ganha um ponto de atenção e conta como Não vistas até você abri-la.

Uma sessão em que você digitou nos últimos 7 dias também mostra um pequeno selo como “hoje” ou “há 2 dias”; passe o mouse para ver o horário exato. Veja Agentes de IA para entender como funcionam o status e as notificações.

Nomes, notas, fixação e cores#

Renomear

Clique duas vezes no nome da sessão e digite. Ou clique com o botão direito → Renomear.

Nota

Uma nota curta abaixo do nome, com até três linhas na barra lateral. Clique com o botão direito → Adicionar nota, ou clique na nota para abrir um editor maior (Enter salva, Shift+Enter adiciona uma linha, Esc cancela). Se você deixar a nota vazia, o PATerminal a preenche com o primeiro prompt que você enviou ao claude / codex naquela sessão, para você distinguir as sessões num relance. Se você apagar a nota, ela fica vazia.

Fixar

Clique com o botão direito → Fixar sessão mantém a sessão no topo do grupo (ou da lista sem grupo).

Cor de fundo

Clique com o botão direito → Fundo da sessão tinge a sessão com uma de seis cores do tema, para destacar trabalhos relacionados.

Copiar uma sessão#

Clique com o botão direito → Copiar sessão abre uma nova sessão de um painel só na mesma pasta — prático para iniciar outro agente no mesmo repositório. Copiar sessão ×N cria várias de uma vez; defina a quantidade com os botões − / +.

Pesquisar, filtrar e ordenar#

• Buscar sessões... filtra a lista enquanto você digita e se combina com o filtro de status.
• O filtro de status acima da lista mostra Todas, só as sessões executando / aguardando / concluídas, as Não vistas ou as Arquivadas. Ao filtrar, qualquer grupo recolhido com resultados é aberto.
• Recentes ordena as sessões numa lista simples pelo último uso. Cada linha passa a mostrar o caminho do grupo acima do nome. Desative para voltar à sua própria ordem e aos grupos.

Arquivar sessões#

Arquive uma sessão que você quer manter mas não precisa ver. Ela some de Todas, mas continua rodando — nenhum processo é parado. Abra o filtro Arquivadas para ver as sessões arquivadas e clique no ícone de desarquivar de uma linha para trazê-la de volta. Um selo no filtro conta as sessões arquivadas recentemente.

Selecionar várias sessões#

Cmd/Ctrl + clique adiciona sessões a uma seleção e Shift + clique seleciona um intervalo. Aparece então uma barra de seleção com Exibir juntas (abre as sessões em uma visualização de sessões divididas), Agrupar, Fechar e Limpar. Você também pode arrastar a seleção inteira para um grupo.

Fechar e restaurar sessões#

Feche uma sessão com o × da linha ou clique com o botão direito → Fechar sessão. Os processos dela são encerrados, mas a sessão não some: as 20 sessões fechadas mais recentes são guardadas com o layout dos painéis, o histórico do terminal, a fixação e a cor.

1. Clique em Histórico na barra de ferramentas.
2. Abra a aba Excluídas recentemente.
3. Clique em Restaurar na sessão que você quer de volta. Ela reabre com os painéis e o histórico da tela.