Kostria

Pasta não é projeto. O Kostria segue o arquivo que a IA editou de verdade, resolve o repositório certo e infere a área do commit e possíveis IDs de ticket — sem proxy, sem SDK, sem mudar código.

O que e

Ferramentas de IA (Claude Code, OpenCode, Codex CLI, Gemini CLI) custam caro e crescem rápido. O painel do fornecedor mostra custo por conta — não por projeto, não por área de trabalho, não pelo ticket validado. Planilha juntada na mão é frágil.

O Kostria lê os logs que essas ferramentas já deixam no disco, segue o arquivo editado até o commit que o fechou e infere dali uma área técnica e possíveis IDs de ticket. Isso não prova que uma feature foi entregue; conectar GitHub Issues, Jira ou Linear permite validar os IDs. No Time, cada pessoa escolhe localmente quais projetos podem entrar no board compartilhado.

$ pip install kostria
$ kostria scan

custo total: $2,480.00   tokens: 1.2B   sessões: 89

by commit scope (illustrative):
   checkout-pix (PROJ-118)     $942.40   38%
   onboarding (PROJ-204)       $719.20   29%
   busca (PROJ-091)            $496.00   20%

Por que atribuir por cwd mente: 65% das edições do Claude Code acontecem em repos que NÃO são o diretório de trabalho. Worktree, monorepo, sessão de terminal — o cwd joga o custo no projeto errado. O Kostria segue o arquivo.

Quickstart

pip install kostria
kostria init      # detecta suas pastas de trabalho
kostria scan      # 30 segundos ate o primeiro resultado
kostria serve     # dashboard em http://127.0.0.1:8787

Zero dependências. Só Python 3.11+ e stdlib.

O que o Kostria responde

• Quanto cada projeto consumiu? Por arquivo editado, não por diretório.
• Onde se concentrou o uso? Arquivo → commit → área técnica inferida; ticket só é confirmado com o rastreador conectado.
• Qual modelo é mais eficiente? Custo por edição entregue, não por token.
• Quanto da assinatura foi usado? Separa consumo real do fixo (Claude Pro/Max).
• Tem conta ociosa? Sinaliza contas sem atividade nos últimos 14 dias.
• O orçamento vai estourar? Projeção mensal + previsão de fechamento do mês.
• O que mudou entre duas janelas? Compare equivalente de API e tokens por dia corrido, com cobertura de preço, sem confundir referência com fatura.
• Onde faltou capacidade? Registre limites, bloqueios e a conta ou o provedor usado para continuar, sem somar quotas incompatíveis.
• Quando revisar uma assinatura? Informe a renovação na Carteira e escolha um aviso opcional por e-mail, de 1 a 30 dias antes.

Suporta

Planos

No Time você escolhe os assentos, com mínimo de 2. Faixas: 2–5 pessoas R$ 39 por pessoa; 6–20 R$ 29; 21–50 R$ 19. Três assentos custam R$ 117/mês; dez, R$ 290/mês. O board avisa se medir mais pessoas do que assentos, sem ajustar a cobrança automaticamente. Veja os preços vigentes.

O motor roda localmente e o código é proprietário. Você pode começar grátis com Claude Code; Pro e Time liberam os outros coletores e a atribuição fina. O board hospedado é opcional. Nos planos Pro e Time, repositórios públicos do GitHub podem validar tickets sem token. Repositórios privados exigem um token de leitura, cifrado pelo Kostria.

Comandos

kostria scan                          # resumo no terminal
kostria scan --since 30d --compare    # contra mes anterior
kostria scan --budget 3000            # alerta de orcamento
kostria scan --anonymize              # mascara nomes (compartilhavel)

kostria report                        # HTML (abre no navegador)
kostria report --format json -o dados.json
kostria report --format csv  -o custos.csv

kostria serve                         # dashboard local em 127.0.0.1:8787
kostria watch                         # vigia ao vivo no terminal
kostria doctor                        # 11 checagens de integridade
kostria contas --json                 # contas locais e planos individuais precificados
kostria badge -o badge.svg            # selo shields.io local

kostria compartilhar                  # no Time: escolha localmente os projetos que podem subir
kostria sync                          # envia somente o recorte autorizado no Time
kostria agendar                       # sync recorrente pelo agendador do SO
kostria agendar --mostrar             # lê o que seria instalado, sem instalar

A partir da 0.2.11, contas lista candidatos locais e preços públicos com fonte/data, sem rede. kostria sync --descobrir-contas autoriza o envio de identificadores opacos e rótulos mascarados para a Carteira no onboarding. Confirme ativa, plano e quem paga; variantes Pro/Max já vêm precificadas. Contas pessoais e pendentes são privadas; períodos financiados pelo time só são compartilhados por escolha do titular. Mudanças preservam histórico.

A Carteira compara períodos por fornecedor/modelo/projeto, separa referências mensais por pagador e registra decisões antes da renovação. O titular também pode confirmar quando um limite bloqueou ou desacelerou o trabalho e onde ele continuou; esses eventos aparecem no antes/depois, sem transformar quotas de provedores diferentes numa soma fictícia. Preço público não é fatura e equivalente de API não mede ROI. As datas são inícios de sessões cumulativas; uso sem conta confiável continua separado da assinatura. O catálogo curado de 90 grupos é conferido diariamente nas cinco fontes oficiais e distribuído no sync. Fonte/formato inválido conserva a última versão íntegra e preços de períodos confirmados continuam preservados.

Depois do kostria login, os comandos do dia a dia (scan, report) podem sincronizar de 6 em 6 horas — sem refazer a varredura. Em workspace Time ou Enterprise, o primeiro envio fica bloqueado até você rodar kostria compartilhar; projetos não escolhidos não entram no payload, nem como total anônimo. kostria compartilhar --limpar deixa a seleção vazia e remove do servidor os dados anteriores desta máquina no próximo sync bem-sucedido. Desligue o envio automático com --sem-autosync (ou autosync = false no kostria.toml). O kostria agendar cobre o caso de quem passa o dia dentro do agente e nunca digita kostria.

Privacidade

• A análise e o relatório rodam localmente e funcionam sem rede. Por padrão, scan envia um ping anônimo de instalação e consulta o PyPI para avisar de atualização; kostria scan --no-telemetry desliga os dois nessa execução. Dados do trabalho só chegam ao board após kostria login e um sync manual, agendado ou oportunista em scan/report.
• No workspace pessoal Pro, o sync envia o agregado: projeto, dia, custo, tokens, área inferida e ID de ticket, os totais por modelo/fornecedor/ferramenta, a base de medição e um identificador irreversível por resposta para deduplicação, o nome desta máquina e o seu plano de IA (valor pago e equivalente em API) com a conta mascarada (a***@dominio). Nunca caminho de arquivo, nunca conteúdo de sessão, nunca o e-mail completo. No Time/Enterprise, só projetos escolhidos localmente são enviados; totais globais, assinaturas e inventário de contas ficam fora porque poderiam revelar dados pessoais por diferença.
• Não quer mandar o plano? kostria sync --sem-assinatura.
• --anonymize troca nomes por hash estável para relatórios compartilháveis.
• Não acredite: confira. kostria sync --dry-run -v imprime o JSON exato que subiria — e não envia nada. É a resposta certa para "o que essa ferramenta manda do meu trabalho para fora?", e vale a pena rodar antes do primeiro sync.

$ kostria sync --dry-run
[dry-run] endpoint: https://kostria.hypermind.space/sync
[dry-run] 255 entries -> workspace 0000…
[dry-run] 3 assinatura(s): a***@empresa.com.br (claude_max_20x, $200.00/mes), …

Por que o Kostria é diferente

Não é um proxy (Helicone). Não é tracing de qualidade (Langfuse). Não é FinOps de cloud (Vantage). É o único que lê os logs que já estão no disco, segue o arquivo até o commit e infere dali área técnica e ID de ticket — sem SDK, sem proxy, sem mudar uma linha de código.

Links

• Site e board do time
• Planos e preços
• Privacidade
• Suporte e segurança: hypermind.ia@gmail.com

Licença

Proprietária e gratuita para usar, inclusive comercialmente dentro da sua empresa: sem cadastro, sem contagem de assento, sem expiração. O que não se pode é redistribuir, modificar ou usar o código para construir um concorrente (texto completo em LICENSE).

Até a versão 0.2.3 o pacote saiu sob MIT, e aquele direito não é revogado — vale para aquelas versões. A licença atual vale da 0.2.4 em diante.

Feito em Vicosa, MG por Pedro Henrique.