Projetos, sessões e painéis

Projeto

Um projeto é uma pasta de repositório, com um nome e uma cor. Ele aparece na lateral e é o lugar onde as sessões nascem. Além da pasta, um projeto guarda o arranjo dos painéis, o que foi configurado para as worktrees e os comandos rápidos que você deixou à mão.

Trocar de projeto é ⌘1 a ⌘9, na ordem em que eles aparecem na lateral, ou pela palheta de comandos. Projeto fixado sobe para o topo do grupo e entra nessa contagem.

Sessão

Uma sessão é um terminal de verdade rodando na sua máquina, com uma pasta, um estado e, quase sempre, um agente. Um projeto tem quantas sessões você quiser, e elas aparecem agrupadas por projeto na lateral, com o contador ao lado do nome.

A sessão nasce com um nome no formato do agente mais o número dela no projeto, e você pode renomear com duplo clique. O nome novo sobrevive a fechar e reabrir o app.

Nem toda sessão tem agente:

• Sessão de agente. Abre com o agente já rodando e, se você escreveu um primeiro pedido, já trabalhando.
• Terminal. Um shell comum, para o que você mesmo quer rodar. É a opção Terminal na lista de agentes, ou ⌘T.

Sessões também podem esperar a vez, ficando na fila atrás de outra, e podem ser conectadas entre si arrastando um card sobre o outro, quando duas tarefas conversam.

Painel

Painel é uma célula da grade do projeto, e a regra é simples: um terminal por painel. A grade vai de um painel único até quatro por quatro, ou seja, dezesseis ao mesmo tempo.

⌘D divide, subindo para a próxima grade e focando o painel vazio. Ao chegar no teto, o app avisa em vez de espremer mais um. Arrastar o título move o terminal para um painel vazio, ou troca de lugar com o que estiver ocupado.

Na tela de Sessões você vê um painel por vez, em tamanho cheio. Ver vários ao mesmo tempo é o papel do Grid, descrito em Agentes em paralelo.

Lugares e modos de ver

A lateral separa duas coisas diferentes, e entender isso economiza confusão: os lugares do app e os modos de ver os mesmos terminais.

Pastas na lateral

Quando a lista de projetos cresce, pastas agrupam o que anda junto. Elas se criam pela palheta de comandos, pelo diálogo de projeto ou pela tela de Projetos, e aceitam arrastar projetos para dentro e para fora.

O botão direito na pasta renomeia, cria um projeto já dentro dela e desfaz a última mudança. A lateral também recolhe: arraste o divisor para menos de 120 pixels e ela vira uma coluna de ícones.

A outra palavra contexto

Você vai ver a palavra contexto em dois sentidos, e eles não são a mesma coisa:

• Trocar de contexto, no atalho ⌘1 a ⌘9, é trocar de projeto.
• O indicador ctx, em porcentagem no rodapé da sessão, é quanto da janela de contexto do agente já foi consumida. Ele fica amarelo a partir de 70 por cento e vermelho a partir de 90, e volta ao normal quando o agente compacta a conversa.