neon-cli: consumo y facturación de Neon desde la terminal

@crafter/neon-cli responde la pregunta que el dashboard de Neon no responde: ¿a dónde se está yendo mi dinero, por proyecto, ahora mismo? Un desglose por proyecto, con colores y ordenable, de horas de cómputo, almacenamiento y egress, en la terminal en ~200ms, con --json para agentes.

¿Por qué no neonctl?

El neonctl oficial es excelente para gestionar recursos, pero no expone el endpoint de historial de consumo. Esta CLI consulta el mismo endpoint v2 de consumo que Neon usa para facturar (/consumption_history/v2/projects), así que los números coinciden con tu factura, y neon invoice lo comprueba hasta el centavo.

Instalación

npm i -g @crafter/neon-cli

O ejecútala una sola vez sin instalar:

npx @crafter/neon-cli usage --json

Autenticación

Consigue una API key en console.neon.tech/app/settings/api-keys, y luego:

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)}'

Límites de granularidad (según la API de Neon): hourly cubre las últimas 168 horas, daily los últimos 60 días, monthly el último año.

Comandos

Enlaces

• GitHub
• npm