@nuez-app/cli

CLI oficial de nuez — operá tu cuenta bancaria desde la terminal.

Instalación

npm install -g @nuez-app/cli

Autenticación

nuez login

Abre el navegador para autenticarte. Las credenciales se guardan en ~/.config/nuez/config.json.

nuez logout      # eliminar credenciales locales
nuez whoami      # ver usuario autenticado

Comandos

Cuenta

nuez balance          # saldo disponible en ARS
nuez cvu              # tu CVU y alias
nuez deposits [--limit <n>]   # últimos depósitos recibidos

Transferencias

nuez send <monto> <cbu|cvu|alias>    # enviar dinero

# Ejemplos:
nuez send 5000 0000633600000000001234
nuez send 1000 hgips.gal

El resultado puede ser:

• submitted — transferencia enviada exitosamente
• pending_approval — requiere aprobación por WhatsApp o Telegram según tu política configurada

Para ver el estado de una transferencia:

nuez payouts show <id>
nuez payouts list
nuez payouts receipt <id>     # comprobante de una transferencia completada

Aprobaciones

nuez approvals    # aprobaciones pendientes vía WhatsApp/Telegram

Las aprobaciones se resuelven por WhatsApp o Telegram — el CLI solo permite consultarlas, no aprobarlas/rechazarlas.

Políticas

nuez policies show                         # ver límites actuales
nuez policies set --per-tx 50000           # límite por transacción (ARS)
nuez policies set --daily 200000           # límite diario (ARS)
nuez policies set --monthly 1000000        # límite mensual (ARS)

Facturas

nuez bills companies [query]                 # buscar compañías de servicios
nuez bills get <company_code> <ref_id>       # consultar una factura
nuez bills pay <company_code> <ref_id> --amount <ars>   # pagar una factura
nuez bills history                           # pagos recientes

# Ejemplos:
nuez bills companies edenor
nuez bills get EDENOR 12345
nuez bills pay EDENOR 12345 --amount 5000

Si la factura requiere que especifiques el monto (facturas OPEN/FIXED), nuez bills pay sin --amount muestra los montos permitidos y termina con código de salida 1 — reintentá con --amount <ars>.

Whitelist

Compañías en el whitelist se pagan sin requerir confirmación:

nuez bills whitelist list
nuez bills whitelist add <company_code> [--limit <ars>]
nuez bills whitelist remove <company_code>

Tarjetas

nuez cards status                              # estado de la cuenta y saldo
nuez cards list [--status <s>]                 # listar tarjetas
nuez cards get <card_id>                       # detalle + últimas transacciones
nuez cards issue <limit_ars> [--label <s>] [--reusable]   # emitir tarjeta
nuez cards cancel <card_id>                    # cancelar y reembolsar saldo no usado
nuez cards secure-link <card_id>               # URL de un solo uso para ver PAN/CVV
nuez cards fund <amount_ars>                   # fondear cuenta de tarjetas desde tu CVU
nuez cards withdraw <amount_ars>               # retirar saldo de la cuenta de tarjetas
nuez cards transactions [card_id]              # historial de transacciones

# Ejemplos:
nuez cards fund 20000
nuez cards issue 5000 --label "Compra online"
nuez cards secure-link <card_id>

Por defecto, nuez cards issue emite una tarjeta de un solo uso (se desactiva después de la primera transacción). Pasá --reusable para dejarla activa para múltiples compras.

Cripto

nuez crypto status                             # estado de la cuenta cripto
nuez crypto activate                           # activar cripto (idempotente)
nuez crypto addresses                          # direcciones de depósito
nuez crypto balances                           # saldos por moneda
nuez crypto auto-swap <on|off>                 # conversión automática a ARS
nuez crypto offramp quote <amount>             # cotización para vender cripto
nuez crypto offramp execute <quote_id> <amount>   # ejecutar la venta

# Ejemplos:
nuez crypto activate
nuez crypto offramp quote 100
nuez crypto offramp execute <quote_id> 100

nuez crypto offramp quote imprime el comando exacto para ejecutar la venta con offramp execute.

API Keys

nuez keys list
nuez keys create <nombre>
nuez keys delete <id>

Webhooks

nuez webhooks show
nuez webhooks set <url>
nuez webhooks delete
nuez webhooks deliveries    # historial de entregas

Opciones globales

nuez --api-url <url>    # override URL de la API
nuez --app-url <url>    # override URL de la web app
nuez <comando> --json   # output en JSON (para scripting)

Releases

El paquete se publica automáticamente en npm al pushear un tag v*:

npm version minor   # o patch / major — bumpeá según los cambios
git push origin main --tags

GitHub Actions corre los tests y publica en @nuez-app/cli.