Kostria

Pasta não é projeto. O Kostria segue o arquivo que a IA editou de verdade, resolve o repositório certo e extrai dali feature e ticket do Jira — em 30 segundos, sem proxy, sem SDK, sem mudar código.

O que e

Ferramentas de IA (Claude Code, OpenCode, Codex CLI) custam caro e crescem rápido. O painel do fornecedor mostra custo por conta — não por projeto, não por feature, não por ticket. Planilha juntada na mão e lenda com erro.

O Kostria lê os logs que essas ferramentas já deixam no disco, segue o arquivo editado até o commit que o fechou, e extrai dali o escopo da feature e o ticket. O board do time agrega isso pra todo mundo, sem a sessão bruta sair do disco de ninguém.

$ pip install kostria
$ kostria scan

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

by feature:
   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.10+ e stdlib.

O que o Kostria responde

• Quanto cada projeto consumiu? Por arquivo editado, não por diretório.
• Quanto cada feature custou? Arquivo → commit → escopo + ticket.
• 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.

Suporta

Planos

O motor e open source (MIT). O board do time e opcional e hospedado.

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 badge -o badge.svg            # selo shields.io local

kostria sync                          # envia agregado pro board do time

Privacidade

• Roda 100% local. Nada sai da máquina sem você pedir.
• O kostria sync envia só o agregado: projeto, dia, custo, tokens. Nunca caminho de arquivo, nunca conteúdo de sessão, nunca e-mail.
• --anonymize troca nomes por hash estável para relatórios compartilháveis.

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 extrai dali feature e ticket — sem SDK, sem proxy, sem mudar uma linha de código.

Mapa completo de concorrentes →

Docs

• Estratégia de lançamento
• Mapa de concorrentes
• One-pager / pitch
• Arquitetura
• Guia de contribuição
• Saas blueprint
• Checklist de lançamento

Testes

python3 -m unittest discover -s tests   # CLI: 388 testes
cd saas && python3 -m pytest -q         # SaaS: 123 testes

O SaaS não exige Postgres: a suite injeta um pool em memória.

Licença

MIT. O CLI é livre. O board hospedado é opcional.

Feito em Vicosa, MG por Pedro Henrique.