Terminais e shells

Para que serve

Cada painel do PrumoGrid é um terminal comum: um PowerShell, um CMD, um WSL ou um Git Bash rodando no Windows, aberto na pasta do projeto selecionado. O que você digita vai para o shell como em qualquer terminal. As CLIs de agente, como Claude Code, Codex e Gemini, são programas seus que rodam dentro desses terminais, com a sua instalação e a sua conta. Os terminais vivem num serviço em segundo plano, o daemon, e por isso continuam rodando quando você fecha a janela.

Quando usar e quando não usar

Use um terminal do PrumoGrid para tudo o que você já faz no terminal: git status, npm test, um servidor local, uma CLI de agente aberta à mão. Nada disso exige etapa, fluxo ou regra.

Escolha o shell pelo lado em que as ferramentas estão instaladas. Se o seu Claude Code está instalado no Linux do WSL, abra um WSL; se está no Windows, abra PowerShell, CMD ou Git Bash. O mesmo nome de agente pode ser duas instalações diferentes, com contas diferentes, uma de cada lado.

Não use um terminal comum quando quiser que o PrumoGrid acompanhe uma tarefa, avise quando ela terminar ou confira o resultado com um comando. Para isso existe a Nova etapa.

Passo a passo

Abrir dois terminais na loja-api

1. Na coluna Projetos, clique no cartão loja-api.
2. Na linha NOVO, acima dos terminais, clique em PowerShell. O mesmo vale para Ctrl+Shift+1.
3. No terminal, rode git status. O prompt mostra PS C:\demo\loja-api>, porque o terminal nasce na pasta do projeto.
4. Clique em Git Bash na mesma linha, ou pressione Ctrl+Shift+4.
5. No Git Bash, rode npm test. A pasta aparece como /c/demo/loja-api, e o cartão do projeto continua contando esse terminal como da loja-api.
6. Confira o cartão: a linha do branch passa a mostrar main e 2 sessões.

Os quatro atalhos seguem a ordem da linha NOVO: Ctrl+Shift+1 PowerShell, Ctrl+Shift+2 CMD, Ctrl+Shift+3 WSL e Ctrl+Shift+4 Git Bash. WSL e Git Bash só funcionam quando estão instalados nesta máquina.

Abrir um agente à mão

1. No PowerShell da loja-api, digite claude (ou codex) e pressione Enter.
2. Se a CLI pedir login ou confiança na pasta, responda no próprio terminal.
3. Peça algo curto, por exemplo Explique em uma frase como funciona o cupom PRIMEIRA.

O PrumoGrid reconhece a CLI desenhada na tela e mostra o estado do painel, como no prompt. Uma tarefa digitada assim é sua conversa com o agente; ela não vira etapa nem aparece na aba Etapas.

Agentes de CLI

O PrumoGrid não instala nem autentica agentes. Instale a CLI e faça o login antes, no lado escolhido. Sem agente nenhum, os terminais funcionam igual.

Claude Code, Codex CLI e Gemini CLI já vêm cadastrados. Para outra ferramenta, abra Ferramentas → Perfis de agente… e use + Cadastrar tipo de agente CLI: cada tipo diz o comando que inicia a CLI, o lado (Windows ou WSL), o arquivo de regras que ela lê (CLAUDE.md, AGENTS.md ou .tg/spec.md) e o que ela consegue informar. Cadastrar um perfil não instala a ferramenta, e marcar uma capacidade que a CLI não tem não faz ela passar a ter.

Em Ferramentas → Agentes → Agente padrão você escolhe entre Claude Code, Codex e Perguntar sempre. Isso define o agente que a Nova etapa sugere.

Aviso de fim de turno

Para saber que um agente terminou de responder, o PrumoGrid depende de um aviso da própria CLI. Nos agentes abertos pela Nova etapa, pelo Fluxo ou por uma rotina, esse aviso já vai no comando de lançamento: não há nada a instalar no projeto.

Fora do PrumoGrid, num terminal de sempre ou no VS Code, o agente termina e ninguém fica sabendo. Para esse caso, abra Ferramentas → Aviso de fim de turno…. A tela diz, uma linha por CLI encontrada, se o aviso está pronto. Instalar no Claude Code mostra o conteúdo e grava no arquivo do projeto; as receitas das outras CLIs ficam em Ver receitas. Confira a mudança no Git antes de versionar.

Esse aviso é diferente das Notificações do Windows, explicadas em Atenção.

Colar prints e imagens

• Copie um print e pressione Ctrl+V no terminal do agente. A imagem vai pelo atalho nativo da CLI, quando ela tem um. O botão direito sem texto selecionado faz o mesmo.
• Ctrl+Shift+V cola o caminho do arquivo. O PrumoGrid guarda o print como PNG na pasta attachments do perfil. No WSL, o caminho já chega convertido para /mnt/....
• Arraste arquivos PNG, JPEG, GIF, WebP ou BMP para um terminal. O caminho entra só naquele terminal, mesmo com o broadcast ligado.

O PrumoGrid não envia nada sozinho. Confira a referência, escreva o pedido e pressione Enter. A CLI e o modelo precisam aceitar imagens ou ler o arquivo indicado.

Interromper, copiar e rolar

Ctrl+C sem texto selecionado interrompe o processo em primeiro plano, como em qualquer terminal. Com texto selecionado, Ctrl+C copia; Ctrl+Shift+C também copia, sem risco de interromper.

Cada terminal guarda 5.000 linhas para você rolar para cima. Para mudar, abra Ferramentas → Opções avançadas…, seção Terminais, campo Linhas de rolagem por terminal: de 1.000 a 50.000. Vale para os terminais abertos depois da mudança. A conversa do agente continua guardada na própria CLI.

O que aparece na tela

Ampliar captura ↗

Ampliar captura ↗

Ampliar captura ↗

Fechar um painel ou encerrar a sessão

O × no cabeçalho do painel, ou Ctrl+Shift+W, abre a pergunta Fechar terminal com duas saídas:

• Fechar e manter a sessão tira o painel da grade. O shell e o processo continuam rodando no daemon.
• Encerrar a sessão termina o shell e todos os processos que ele criou. Trabalho não salvo pode ser perdido.

Fechar a janela do PrumoGrid é outra coisa: os terminais continuam no daemon e voltam quando você abre de novo. Para parar tudo existe Encerrar daemon e todas as sessões, no indicador de sessões persistentes do rodapé, que pede confirmação e diz quantos terminais serão encerrados.

Dicas

• Dê dois cliques no nome do painel para renomear. Nomes como Revisor e Implementador ajudam quando há vários agentes iguais. Veja Organizar projetos e terminais.
• Nos terminais do PrumoGrid, tg --help mostra a ajuda da integração local, usada pelos agentes para sinalizar o fim de uma tarefa.
• O CMD expande variáveis até entre aspas. Se o PrumoGrid recusar abrir um agente pelo CMD porque a instrução tem um caractere como %, abra o agente pelo PowerShell ou pelo Git Bash.
• Se você quer ler um terminal com calma, use o Foco.

Limites conhecidos

• O PrumoGrid não instala, atualiza nem autentica CLIs de agente, e não muda as configurações delas.
• Prints colados ficam em attachments dentro do perfil até você apagar. Cada print tem até 20 MB e 40 milhões de pixels; um arraste aceita até 16 arquivos.
• Uma pasta que só existe dentro do WSL não recebe regras pelo Windows nem pode ter worktree criado pelo Git do aplicativo.
• A rolagem do terminal tem o teto escolhido em Linhas de rolagem por terminal. Ela não substitui o histórico da CLI nem um backup dos arquivos.