neon-cli: consumo e faturamento do Neon pelo terminal

@crafter/neon-cli responde a pergunta que o dashboard do Neon não responde: para onde está indo meu dinheiro, por projeto, agora mesmo? Um detalhamento por projeto, colorido e ordenável, de horas de compute, armazenamento e egress, no terminal em ~200ms, com --json para agentes.

Por que não o neonctl?

O neonctl oficial é ótimo para gerenciar recursos, mas não expõe o endpoint de histórico de consumo. Esta CLI consulta o mesmo endpoint v2 de consumo que o Neon usa para faturamento (/consumption_history/v2/projects), então os números batem com sua fatura, e neon invoice prova isso até o centavo.

Instalação

npm i -g @crafter/neon-cli

Ou execute uma única vez sem instalar:

npx @crafter/neon-cli usage --json

Autenticação

Pegue uma API key em console.neon.tech/app/settings/api-keys e depois:

neon auth login         # prompts for the key, stores it at ~/.neon/config.json (mode 0600)
# or
export NEON_API_KEY=napi_...   # env var always wins

Uso

neon usage                                   # this month, daily, all projects
neon usage --last 24h --granularity hourly   # last 24 hours, hourly buckets
neon usage --project shy-darkness-12345      # one project + per-bucket chart
neon usage --org org_abc123                  # scope to one org
neon usage --json | jq '.projects[] | {id: .project_id, cu_h: (.totals.compute_unit_seconds/3600)}'

Limites de granularidade (conforme a API do Neon): hourly cobre as últimas 168 horas, daily os últimos 60 dias, monthly o último ano.

Comandos

Links

• GitHub
• npm