Busca e atalhos

Para que serve

Quando há três projetos e meia dúzia de terminais abertos, ir com o mouse até cada coisa cansa. A paleta de comandos (Ctrl+K) acha um comando ou um terminal pelo nome. A busca (Ctrl+Shift+F) procura dentro do texto: na saída dos terminais, nas etapas e nas regras. Os atalhos de teclado cobrem o resto, como trocar de terminal, ampliar um painel ou incluir um painel no broadcast. Dá para trabalhar a maior parte do dia sem tirar a mão do teclado.

Quando usar e quando não usar

Use a paleta quando você sabe o que quer fazer e não lembra onde fica: "Rotinas", "Instruções enviadas", "Verificação do projeto…". Use a busca quando você lembra de um texto e não sabe onde ele apareceu: o nome de um arquivo que um agente citou, uma mensagem de erro, uma palavra de uma regra.

A busca não procura dentro dos arquivos do projeto. Ela olha o que está nos terminais, nas etapas e nas regras do PrumoGrid. Para procurar no código, use o terminal (git grep, por exemplo) ou peça a um agente.

Passo a passo

Abrir um comando pela paleta

1. Pressione Ctrl+K, ou abra Ferramentas → Paleta de comandos….
2. Comece a digitar o nome do comando, por exemplo rot. A lista filtra e mostra Rotinas, com o atalho Ctrl+Shift+U ao lado.
3. Use as setas para escolher e Enter para executar. Esc fecha a paleta.

A paleta reúne os destinos mais usados:

• Em Ir para, Grade, Foco e Fluxo. Grade e Foco já levam o teclado ao terminal, pronto para digitar.
• Cada terminal aberto, com o estado ativo ou encerrado.
• Trocar para um projeto, como Trocar para portal-web.
• Nova etapa, Rotinas, Instruções enviadas, Atenção e Notificações.
• Com um projeto selecionado, Verificação do projeto… abre a verificação dele.
• Atalhos, com a lista de teclas.

Se nenhum comando tiver o nome digitado, a paleta mostra o botão Buscar conteúdo, que abre a busca já com o texto que você escreveu.

Procurar um texto nos terminais, etapas e regras

O exemplo procura onde o cupom PRIMEIRA apareceu na loja-api.

1. Pressione Ctrl+Shift+F ou clique no campo buscar terminal, etapa ou regra… no topo da janela.
2. Digite cupom. A busca começa a partir de duas letras.
3. Leia os resultados, agrupados por origem. No exemplo, o terminal Claude Code tem 4 ocorrências, cada uma com o número da linha (L11, L13, L15 e L17) e o trecho.
4. Clique numa ocorrência para ir até ela.
5. Pressione Esc para fechar a busca. O foco volta para onde você estava.

No Foco, Ctrl+F faz outra busca: só dentro da conversa do terminal em destaque.

Procurar dentro de uma conversa, no Foco

1. Clique em Foco e traga o terminal para o centro.
2. Pressione Ctrl+F ou clique no campo Buscar nesta conversa, no topo do terminal.
3. Digite o trecho, por exemplo subtotal. As ocorrências ficam marcadas no terminal e o contador mostra 1 de 3.
4. Pressione Enter para a próxima e Shift+Enter para a anterior, ou use as setas ao lado do campo.
5. Pressione Esc ou o × para limpar a busca. O teclado volta ao terminal.

Para voltar a uma instrução sua, e não a um trecho qualquer da resposta, use o Guia de prompts, ao lado do mesmo campo.

O que dá para procurar

A busca (Ctrl+Shift+F) olha três fontes ao mesmo tempo e mostra cada uma no seu grupo:

Clicar num resultado leva até ele:

• Terminal: troca para o projeto do terminal, se for preciso, põe o terminal em foco, rola até a linha e seleciona o trecho.
• Etapa: abre a aba Etapas e mostra o terminal em que a etapa roda.
• Regra: troca para o projeto da regra, se for preciso, e abre a regra em Regras e papéis.

Os grupos não procuram do mesmo jeito. Nos terminais, a busca acha o trecho exatamente como digitado, sem diferença entre maiúsculas e minúsculas, mas com os acentos. Nas etapas e nas regras, cada palavra precisa aparecer, em qualquer ordem, e os acentos não contam: cupom primeira acha a etapa "Corrija o cupom PRIMEIRA", e portugues acha a regra "Responda sempre em português do Brasil".

O que aparece na tela

Ampliar captura ↗

Ampliar captura ↗

Todos os atalhos

Esta é a lista de Ferramentas → Atalhos de teclado… na versão 0.5.11. Dentro de um campo de texto o PrumoGrid não sequestra teclas: o que você digita é do campo.

Ampliar captura ↗

Esc e o retorno do foco

O Esc fecha a superfície que está por cima: a busca, a paleta, um diálogo. Algumas regras ajudam a não perder o lugar:

• Fechar uma superfície devolve o foco para onde ele estava, normalmente o terminal em que você digitava.
• Depois de clicar no cabeçalho de um diálogo, o Esc continua fechando esse diálogo.
• Sem terminal na tela, fechar com Esc devolve o foco ao botão Ferramentas.
• Quando o foco volta a um terminal que estava fora da vista, a Grade rola até ele.

Clicar nas abas da lateral ou em Grade e Foco na barra também não tira o foco do terminal em que você digitava.

Dicas

• Alt abre Ferramentas, e as letras sublinhadas nos itens funcionam como atalho dentro do menu.
• Ctrl+1 a Ctrl+9 seguem a ordem dos terminais do projeto selecionado. Arrume a ordem com Ctrl+Shift+← e Ctrl+Shift+→ para que o agente principal fique sempre no 1.
• Ctrl+C sem seleção manda a interrupção para o processo, como em qualquer terminal. Para copiar sem risco, selecione antes ou use Ctrl+Shift+C.
• Para colar uma imagem num agente, copie o print e use Ctrl+V no terminal; Ctrl+Shift+V insere o caminho de um arquivo salvo. Veja Terminais e shells.
• A busca de instruções já enviadas fica em Instruções enviadas (Ctrl+Shift+I), com campo próprio. Veja Histórico e gravação.

Limites conhecidos

• A busca exige pelo menos duas letras e não procura nos arquivos do projeto.
• A busca nos terminais olha o texto que ainda está na rolagem de cada um. O que saiu da rolagem não aparece.
• A busca mostra até 200 resultados: até 40 ocorrências por terminal, com 80 lugares reservados para etapas e regras. Se o termo for comum, acrescente uma palavra.
• No Foco, a busca na conversa avisa quando passa de 2.000 ocorrências e pede para refinar o termo.
• Em campos de texto, as teclas de edição e navegação do próprio campo têm prioridade sobre os atalhos.