O agente começa a esquecer o que você combinou, as respostas ficam mais lentas, e você não sabe se o problema é a conversa longa, um MCP pesado ou um AGENTS.md que cresceu demais. O /context da Verboo Code responde isso em um comando: mostra quanto da janela de contexto está ocupado e por quê, categoria por categoria. Este guia mostra como ler a saída e o que fazer com cada linha.
O que o /context mostra na Verboo Code?
Uma grade colorida com o uso atual da janela de contexto, o total em tokens e em porcentagem, e uma lista do que está ocupando esse espaço. A descrição do comando no código é literal: "Visualize current context usage as a colored grid".
/contextA primeira linha traz o modelo e o total, no formato modelo · usados/janela tokens (N%). Logo abaixo vem o bloco Estimated usage by category, e depois o detalhe de cada fonte: MCP, agentes, arquivos de instrução e skills.
O número é o que o modelo realmente recebe, não o histórico bruto da tela. Antes de contar, o comando aplica as mesmas transformações que a CLI aplica antes de chamar a API: descarta o que ficou antes da última compactação e reduz resultados antigos de ferramenta. Por isso o total pode ser menor do que a conversa parece.
O que significa cada categoria?
Cada linha é uma fonte de tokens. Algumas você controla direto, outras não. A tabela mostra os nomes exatamente como aparecem na tela e onde mexer:
| Categoria | O que é | Onde mexer |
|---|---|---|
System prompt | Instruções base da CLI | Não é ajustável no dia a dia |
System tools | Definição das ferramentas nativas (ler, editar, rodar comando) | Não é ajustável no dia a dia |
MCP tools | Ferramentas dos servidores MCP conectados | /mcp |
Custom agents | Agentes personalizados disponíveis | /agents |
Memory files | AGENTS.md, CLAUDE.md e regras carregadas | /memory |
Skills | Cabeçalho das skills instaladas | /skills |
Messages | A conversa: suas mensagens, respostas e resultados de ferramenta | /compact ou /clear |
Autocompact buffer | Folga reservada para a compactação automática | /config (Auto-compact) |
Free space | O que ainda cabe | Nada a fazer |
Tudo até Skills é custo fixo: entra em toda chamada, mesmo antes de você digitar a primeira mensagem. Messages é o que cresce durante a sessão.
Por que algumas linhas mostram N/A?
São as categorias MCP tools (deferred) e System tools (deferred). Quando a busca de ferramentas está ativa, essas ferramentas ficam fora do contexto e só são carregadas quando o agente precisa delas. O /context mostra o tamanho delas para você ter visibilidade, mas elas não entram no total, por isso a porcentagem aparece como N/A. No detalhe de MCP, o título vira MCP tools · /mcp (loaded on-demand) e a lista se divide em Loaded e Available.
O que é o Autocompact buffer?
É espaço reservado, não espaço usado. Com o Auto-compact ligado, a Verboo Code compacta a conversa quando o uso encosta nessa folga, e a grade mostra a reserva para você ver quanto falta até lá. Com o Auto-compact desligado, a linha vira Compact buffer, uma reserva menor que garante espaço para o /compact manual.
Como descobrir o que está pesando?
Olhe a maior categoria fixa primeiro. Ela aparece em toda chamada, então cortar ali rende mais do que compactar a conversa. Abaixo do bloco de categorias, o /context lista cada item com o seu custo:
Memory files · /memory
└ AGENTS.md: 6.2k tokens
└ docs/arquitetura.md: 4.8k tokensO exemplo acima é ilustrativo, mas o formato é o do código: cada seção traz o comando que gerencia aquela fonte ao lado do título. Se o maior número está num arquivo importado com @ no AGENTS.md, tire o import e deixe só o que o agente erraria sem ler. Se está num servidor MCP que você não usa neste projeto, desligue em /mcp.
O que significam os avisos no fim do /context?
O comando fecha com sugestões geradas a partir dos números da sessão. Elas só aparecem quando passam de um limite definido no código:
| Aviso | Quando aparece | O que fazer |
|---|---|---|
Context is N% full | Uso em 80% ou mais | Rode /compact agora, dizendo o que preservar |
Bash results using ... tokens | Saída de comandos acima de 15% da janela e de 10 mil tokens | Peça para filtrar com head, tail ou grep |
Read results using ... tokens ou File reads using ... tokens | Leitura de arquivos acima de 15% da janela (ou resultados de leitura acima de 5%), sempre com mais de 10 mil tokens | Ler só o trecho necessário, sem reler o arquivo inteiro |
Memory files using ... tokens | Arquivos de instrução acima de 5% da janela e de 5 mil tokens | Enxugar com /memory |
Autocompact is disabled | Auto-compact desligado e uso entre 50% e 80% | Ligar em /config ou compactar na mão |
O aviso de 80% muda conforme a configuração. Com o Auto-compact ligado, ele avisa que a compactação automática vai disparar logo e descartar mensagens antigas, e sugere rodar /compact antes para você decidir o que fica. Com ele desligado, sugere /compact ou religar em /config.
Como liberar contexto depois de ler o /context?
Na ordem do diagrama: primeiro o custo fixo, depois a conversa.
- Corte o que é fixo.
/memorypara enxugar instrução,/mcppara desligar servidor sem uso,/skillspara revisar skills. - Resuma a conversa quando
Messagesdomina. Diga o que não pode se perder:/compact preserve os arquivos alterados e a decisão de manter a API v1 - Comece do zero com
/clearse a próxima tarefa não depende da anterior. Os arquivos de instrução continuam no disco e voltam a ser lidos.
Rode /context de novo no fim para conferir quanto liberou. O passo a passo da compactação, com as variáveis de ambiente do Auto-compact, está no guia do /compact na Verboo Code.
Dá para ver o uso de contexto sem abrir a sessão?
Dá. Em modo não interativo o /context devolve o mesmo levantamento como texto, em tabelas Markdown, em vez da grade colorida:
verboo -p "/context"Para medir a conversa mais recente da pasta atual, combine com -c, que continua a última sessão:
verboo -c -p "/context"A saída começa com ## Context Usage, traz as linhas **Model:** e **Tokens:** e depois as tabelas por categoria, MCP, agentes, arquivos de instrução e skills. É texto puro, então dá para salvar num arquivo e comparar o custo fixo antes e depois de mexer no AGENTS.md.
Como isso se encaixa com os outros comandos?
- O /memory edita os arquivos que aparecem em
Memory files. - O guia de MCP mostra como adicionar e remover os servidores que aparecem em
MCP tools. - O /plan ajuda a chegar no código com menos idas e vindas, o que segura o crescimento de
Messages.
Na Verboo Code o token é ilimitado, então o /context serve para manter o agente afiado, não para economizar na fatura: crie a conta em verboo.ai, abra a CLI no seu repositório e rode /context antes da próxima sessão longa.
