Consumo e limites

Para que serve

Com vários projetos e agentes abertos, a máquina pesa e fica difícil saber qual terminal é o responsável. O PrumoGrid mede cada terminal somando todos os processos que ele abriu (o shell, o agente, um npm test que o agente disparou) e mostra o resultado no cabeçalho do painel, no rodapé e na aba Consumo. Na mesma aba ficam os tokens que as CLIs informam por sessão. Quando um terminal passa da conta, você pode pôr um limite de memória e de CPU nele ou encerrar a sessão.

Veja no vídeo

VÍDEO 12 · 1:03

Vários projetos no dia a dia. Uma permissão de outro projeto pela Atenção, os filtros de Etapas, o Consumo, o encerramento de um terminal e a busca. Legendas e transcrição ↗

Quando usar e quando não usar

Use quando a máquina ficar lenta e você quiser achar o terminal pesado, quando um agente deixar processos rodando, ou para acompanhar quanto uma conversa já acumulou de tokens antes de mandar mais uma etapa para ela.

Não use os números de tokens como conta a pagar: eles não são faturamento nem rateio por etapa. E não leia sem dado como zero. Quer dizer que a CLI não informou, ou que o PrumoGrid não conseguiu ler com segurança.

Ligar a aba Consumo

O consumo de cada terminal aparece sempre no cabeçalho do painel, como 0% · 141M (CPU e memória), e o total fica no rodapé, como 3 terminais · 0% CPU · 381 MB RAM · GPU indisponível. A aba Consumo da lateral direita, com o detalhe por terminal, só aparece quando o interruptor Ferramentas → Abas Regras e Consumo na lateral está ligado. Ele começa desligado. Ligue uma vez e as abas Regras e Consumo passam a ficar ao lado de Atenção e Etapas.

Passo a passo

Achar o terminal pesado

1. Ligue Ferramentas → Abas Regras e Consumo na lateral, se ainda não estiver ligado.
2. Selecione o projeto, por exemplo a loja-api, e clique na aba Consumo.
3. Leia a lista Consumo por terminal. A primeira linha soma tudo; abaixo vem uma linha por terminal, com o nome, a CPU, a memória e a leitura e escrita em disco.
4. Passe o mouse no detalhe de uma linha: a dica diz quantos processos entram na soma daquele terminal.
5. Clique na linha para ir ao terminal na Grade e confirmar pelo nome e pela pasta que é o terminal que você imagina.

Pôr um limite num terminal

O exemplo limita o terminal do Codex na loja-api a 4 GB de memória e metade da CPU.

1. Na linha do terminal, clique em Limitar….
2. Preencha memória (MB) com 4096 e CPU (%) com 50. Deixe um campo vazio para não limitar aquela grandeza.
3. Clique em Aplicar. O aviso confirma os limites aplicados, e a linha passa a mostrá-los.
4. Para tirar os dois limites, abra Limitar… de novo e clique em Sem limites.

O mesmo ajuste existe em Ferramentas → Limites de memória e CPU…, que abre a seção de mesmo nome em Opções avançadas…. Ali você escolhe o terminal em Terminal e preenche os mesmos campos. Os limites valem só para a sessão escolhida; alterar um terminal não muda os outros.

Encerrar uma sessão parada

No fim do dia sobra terminal aberto. No exemplo, um PowerShell da pagamentos está parado há horas.

1. Na aba Consumo, com Todos os projetos ou com pagamentos selecionado, ache a linha do PowerShell.
2. Clique em Encerrar sessão e confirme. Isso encerra o shell e todos os processos que ele criou, filhos e netos.
3. O painel continua na grade mostrando a última saída, e dá para reiniciar por ele. Para tirar o painel também, use Fechar painel.

Fechar painel sozinho faz outra coisa: tira o painel da grade, e a sessão continua viva no serviço de terminais. É útil para arrumar a tela sem perder o que está rodando.

Tokens por sessão

Na aba Consumo, expanda Tokens por sessão com o projeto selecionado. Aparecem a entrada e a saída das conversas observadas, o total do projeto e as sessões que o compõem, inclusive de terminais já encerrados.

Cada sessão é contada uma vez. Quando a CLI informa a identidade da conversa, retomar essa conversa em outro terminal não soma o mesmo consumo duas vezes. Uma conversa nova no mesmo terminal tem medição própria. Os totais ficam guardados ao reabrir a janela.

Separe dois números que parecem iguais. O contexto atual é quanto da janela de contexto a conversa ocupa agora, como o que a barra do Claude mostra. O acumulado é tudo o que entrou e saiu desde o começo da conversa. Um contexto baixo não significa pouco consumo acumulado, e vice-versa.

O que aparece na tela

Ampliar captura ↗

Ampliar captura ↗

Dicas

• Antes de encerrar, identifique o terminal pelo nome e pela pasta. Clicar na linha leva até ele.
• Se um agente vai rodar uma tarefa pesada, como uma suíte longa de testes, limite o terminal dele e deixe os outros livres.
• Com dois terminais Codex na mesma pasta, o PrumoGrid não sabe qual arquivo de conversa é de qual, e modelo e contexto ficam sem dado. Use um worktree para o segundo.
• Para ver o que está pendente em vez do que está pesado, use a Atenção.

Limites conhecidos

• Memória de 64 MB a 1.048.576 MB; CPU de 1% a 100%. O limite vale para a sessão, enquanto ela existir.
• O PrumoGrid não mede GPU por terminal.
• Tokens dependem do que cada CLI grava. O aplicativo não reconstrói conversas antigas que nunca observou.
• Os números não são custo de faturamento nem rateio por etapa.
• Os campos de memória e CPU sugeridas de um papel não aplicam limite nenhum. O limite vem só de Limitar… ou de Limites de memória e CPU….