Kostria

Pasta nao e projeto. O Kostria segue o arquivo que a IA editou de verdade, resolve o repositorio certo e extrai dali feature e ticket do Jira — em 30 segundos, sem proxy, sem SDK, sem mudar codigo.

O que e

Ferramentas de IA (Claude Code, OpenCode, Codex CLI) custam caro e crescem rapido. O painel do fornecedor mostra custo por conta — nao por projeto, nao por feature, nao por ticket. Planilha juntada na mao e lenda com erro.

O Kostria le os logs que essas ferramentas ja deixam no disco, segue o arquivo editado ate 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 sessao bruta sair do disco de ninguem.

$ pip install kostria
$ kostria scan

custo total: $2,480.00   tokens: 1.2B   sessoes: 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 edicoes do Claude Code acontecem em repos que NAO sao o diretorio de trabalho. Worktree, monorepo, sessao 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 dependencias. So Python 3.10+ e stdlib.

O que o Kostria responde

• Quanto cada projeto consumiu? Por arquivo editado, nao por diretorio.
• Quanto cada feature custou? Arquivo → commit → escopo + ticket.
• Qual modelo e mais eficiente? Custo por edicao entregue, nao por token.
• Quanto da assinatura foi usado? Separa consumo real do fixo (Claude Pro/Max).
• Tem conta ociosa? Sinaliza contas sem atividade nos ultimos 14 dias.
• O orcamento vai estourar? Projecao mensal + previsao de fechamento do mes.

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 maquina sem voce pedir.
• O kostria sync envia so o agregado: projeto, dia, custo, tokens. Nunca caminho de arquivo, nunca conteudo de sessao, nunca e-mail.
• --anonymize troca nomes por hash estavel para relatorios compartilhaveis.

Por que o Kostria e diferente

Nao e um proxy (Helicone). Nao e tracing de qualidade (Langfuse). Nao e FinOps de cloud (Vantage). E o unico que le os logs que ja estao no disco, segue o arquivo ate o commit e extrai dali feature e ticket — sem SDK, sem proxy, sem mudar uma linha de codigo.

Mapa completo de concorrentes →

Docs

• Estrategia de lancamento
• Mapa de concorrentes
• One-pager / pitch
• Arquitetura
• Guia de contribuicao
• Saas blueprint
• Checklist de lancamento

Testes

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

O SaaS nao exige Postgres: a suite injeta um pool em memoria.

Licenca

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

Feito em Vicosa, MG por Pedro Henrique.