FaundrDocumentaçãoAbrir o painelPainel

O painel do projeto

Insights e custo

Insights é a primeira tela do projeto: o painel com o contexto da conversa, os limites de uso, o custo, os tokens e a saúde do projeto. Ele mostra quanto o Faundr gasta e economiza de tokens, quanto as sessões custam em dinheiro e como a saúde do projeto mudou desde que o Faundr foi ligado. Não precisa de comando: os números chegam sozinhos.

Painel

A aba que abre junto com o projeto.

  • Contexto da conversa, janela de 5 horas e limite da semana: o quanto já foi usado na última sessão, com quando cada janela zera. Em 80% o card fica em destaque. No Claude Code, esses números vêm da barra do Faundr no terminal: sem a barra ligada, o card explica como ligar (!faundr statusline-install). No Codex, que não tem a barra, eles vêm da própria conversa. Os limites são da conta de quem estava na sessão, não do projeto.
  • Custo este mês, janela de 5 h em dólares, parte do Faundr (o que ele gastou e o que o mapa evitou) e problemas corrigidos. Clique num deles para abrir a aba com o detalhe.
  • Custo por dia e tokens por dia nos últimos 14 dias. Passe o mouse numa barra para ver o dia.
  • Saúde agora: os problemas abertos de cada área e se melhorou desde a primeira foto.
  • Últimas sessões, com o custo de cada uma.

Com duas pessoas no projeto

  • Contexto, janela de 5 horas e semana são sempre seus. Esses limites são da sua conta da IA. Logo abaixo, uma linha mostra os de cada outra pessoa do time (da última sessão dela, até um dia atrás).
  • Time ou Só eu. O seletor no topo troca custo, tokens e últimas sessões entre o projeto inteiro e só as suas sessões. A saúde do projeto é sempre do projeto.
  • A janela de 5 horas em dólares é de cada pessoa, no Painel, na aba Custo e no aviso de orçamento que o agente recebe. A sessão do seu sócio nunca entra na sua janela.
  • Quem gastou o quê: as listas de sessões mostram o nome de cada pessoa, e a aba Custo tem Por pessoa, este mês.

Como os números chegam

  • No fim de cada resposta, o plugin soma os tokens da conversa do agente e envia só os números: tokens por modelo, ferramentas usadas, quanto o Faundr pôs no contexto e quanto custou o aviso do fim da resposta. A medição lê a conversa no seu computador e envia só a contagem; o texto da conversa não vai junto com ela.
  • A barra do terminal guarda o contexto e os limites de uso que o agente mostra nela, e o fim da resposta envia junto (só as porcentagens e quando zeram). No Codex, os mesmos números são lidos da conversa, no seu computador.
  • A cada checagem de segurança, qualidade, design, testes ou erros, o Faundr guarda uma foto dos números do projeto, quando algum mudou. Isso vale também quando uma skill conectada registra o que achou.

Tokens

O título responde à pergunta principal: "O Faundr ficou com ~N% dos tokens".

A barra Para onde foram os tokens divide o total em três partes:

ParteO que é
Trabalho da IAO que o agente gastou fazendo o que você pediu.
Contexto do FaundrO resumo do início da sessão, as regras dos arquivos e os avisos. É uma estimativa.
Aviso do fim da respostaO que custaram os pedidos do fim da resposta (prova, bilhete, revisão de design…).

Os contadores mostram o total de tokens, o contexto do Faundr, o aviso do fim, quantas vezes o aviso disparou e quantas consultas ao mapa do código foram feitas.

O card O que o mapa do código evitou estima quantos tokens de leitura as consultas ao mapa pouparam: é quanto o agente gastaria abrindo os arquivos que o mapa citou. É um teto, não uma medida exata.

Custo

Quanto as sessões custaram em dólares, calculado pelo preço da API do modelo usado (a tabela de preços da Anthropic).

Se você usa a IA por uma assinatura (planos Pro ou Max), não paga por token. Nesse caso, o custo serve para comparar sessões e funcionalidades, e para ver quanto você está aproveitando do plano.
  • Este mês: o gasto do mês, e o orçamento, se houver.
  • Sua janela de 5 h: o seu gasto na janela de uso atual. Os planos Pro e Max limitam o uso em janelas de 5 horas, uma por conta.
  • Sessões medidas, média por sessão e total medido.
  • Por funcionalidade: quanto custou construir cada funcionalidade.
  • Janelas de 5 horas: o gasto de cada janela, com a que está aberta agora.
  • Sessões mais caras.

O custo usa a tabela de preços dos modelos da Anthropic. Um modelo sem preço conhecido (por exemplo, os do Codex) fica fora da soma, e a aba Custo lista o nome dele em Sem preço conhecido (fora da conta). Os tokens dele continuam contando nas abas Painel, Tokens e Por sessão.

Orçamento

Defina um limite por mês (soma o time) e/ou por janela de 5 horas (vale para cada pessoa), em dólares, e a partir de que porcentagem avisar (o padrão é 80%). Quando o gasto passa desse ponto, o agente recebe um aviso no início da próxima sessão e o painel mostra um alerta. Deixe os dois valores vazios para remover o orçamento.

Saúde do projeto

Como o projeto mudou desde a primeira foto:

  • quantos problemas foram corrigidos desde então, e quantos sumiram na mesma conversa em que apareceram;
  • um card por área (segurança, qualidade, design, erros, testes), com o número atual e uma linha do tempo;
  • se a área melhorou ou piorou desde o começo.

Os problemas que as skills conectadas acham (os com via /nome) entram na conta junto com os do Faundr.

A linha do tempo mostra o projeto desde que o Faundr foi ligado, mas não prova que a melhora veio dele: o time também corrige coisas por conta própria.

Por sessão

Uma linha por conversa: tokens, respostas, pedidos, a parte do Faundr, quantas vezes o aviso do fim disparou, quantas consultas ao mapa e se o contexto foi resumido no meio. Com o time inteiro, cada linha mostra de quem é a sessão. Busque por pessoa, branch ou data.

Gastar menos do plano

  • Modo econômico: em Configurações → Geral, faz a auditoria rápida de design e a atualização da Visão e da Stack rodarem só quando você pedir. O cartão mostra quanto o fim das respostas custou nos últimos 30 dias. Veja Configurações.
  • Antes de gerar algo com IA: o /faundr:setup separa o que é grátis (mapa, Stack lida dos arquivos, checagens) do que usa o plano (Visão, revisões, design.md…) e mostra a estimativa de cada item em tokens, em % da janela de 5 horas e da semana e em dólares pela API. A estimativa começa pelo tamanho do código e passa a usar o gasto medido de verdade nas vezes em que a skill já rodou.

Para conferir o que é enviado

Rode !faundr usage --debug no agente para ver, em JSON, exatamente os números que o Insights receberia da conversa mais recente.

Comandos

O Insights é a primeira tela do projeto: contexto da conversa, janelas de 5 horas e da semana, custo e tokens por dia. Mostra o que o Faundr gasta e economiza de tokens, quanto as sessões custam em dinheiro (por mês, janela de 5 horas, funcionalidade e sessão, com orçamento e aviso) e como a saúde do projeto muda desde que ele foi ligado. Não precisa de comando: os números chegam sozinhos. Use estes comandos no seu agente de IA, na pasta ligada ao projeto.

No fim de cada resposta, o plugin soma os tokens da conversa com o agente (só os números, nunca o texto). A cada checagem de segurança, qualidade, design, testes ou erros, o Faundr guarda uma foto dos números do projeto, quando algum mudou.

  • !faundr graph-query "<pergunta>"

    Pergunta ao mapa do código e recebe só o trecho que importa, em vez de a IA abrir vários arquivos. No fim da resposta aparece quanto ela custou e quanto os arquivos citados custariam: é a economia que o Insights soma.

    ex.: !faundr graph-query "como funciona o login"

  • !faundr usage --debug

    Mostra os números de uso que o Insights receberia da conversa mais recente, para conferir o que é enviado.