Terminal

CLI

Todo el hub desde la terminal, sin instalar nada: alcanza con Node 20 o más nuevo.

terminal

npx talo-hub login

El login abre el navegador y muestra un código de seis caracteres: confirmás que es el mismo en las dos pantallas y autorizás en Talo. La key queda en tu configuración local, solo legible por tu usuario.

Comandos

`talo-hub login [--production]`	Conecta tu cuenta Talo desde el navegador (sandbox por defecto). Termina solo cuando autorizás; si se cortó, correrlo de nuevo retoma el mismo login.
`talo-hub logout [--production \| --all]`	Revoca la key guardada en el hub y la borra de tu máquina.
`talo-hub disconnect --yes [--production]`	Desconecta tu cuenta del hub: borra su copia de la autorización de Talo y revoca todas las keys y webhooks. Producción pide --production.
`talo-hub use <sandbox\|production>`	Elige el entorno de los próximos comandos.
`talo-hub status`	Cuenta conectada, su estado y los permisos de la key.
`talo-hub doctor`	Checklist para pasar a producción, con lo que falta (sale con 1 si falta algo).
`talo-hub payments create --amount 15000 [--external-id] [--motive]`	Crea un pago y muestra el CVU, el alias y el snippet del widget para tu página.
`talo-hub payments get <id>`	Estado de un pago.
`talo-hub payments list [--from] [--to]`	Pagos de un período (30 días por defecto).
`talo-hub payments refund <id> [--amount]`	Reembolso total o parcial.
`talo-hub sandbox pay <id> [--amount]`	Simula la transferencia del comprador.
`talo-hub links create --title <título> (--amount <ARS> \| --min <ARS> --max <ARS>) [--description] [--redirect-url]`	Crea un link de pago reutilizable (precio fijo, o un rango en el que elige el comprador) y muestra su URL y la de su QR.
`talo-hub links list \| get <id> \| disable <id>`	Tus links de pago, uno con los pagos que se crearon con él, o desactivarlo para siempre.
`talo-hub events list [--payment <id>] [--type <tipo>] [--after <id>] [--limit]`	Eventos recientes, filtrables por cobro o tipo.
`talo-hub events listen [--forward-to <url\|puerto>]`	Recibe eventos en vivo y los reenvía a localhost, sin túneles.
`talo-hub webhooks list \| add <url> [--vercel <env> \| --dotenv <archivo>] \| remove <id> \| test <id>`	Webhooks firmados: registrar (probando antes la URL), quitar y mandar un evento de prueba.
`talo-hub keys list \| create --name <nombre> [--scope] [--vercel <env> \| --dotenv <archivo>] \| revoke <id>`	Keys para tus proyectos (scope charge por defecto), guardadas en Vercel o en tu .env sin mostrarlas.
`talo-hub balance, transactions [--from] [--to] [--limit] [--cursor]`	Saldo y movimientos (cuando Talo los habilite para partners).
`talo-hub mcp [--client claude\|cursor\|desktop] [--with-key]`	Configuración del MCP lista para pegar: OAuth por defecto, o con tu key.
`talo-hub skills list \| install [--stack <kit>] [--global]`	Instala las skills de Talo en .claude/skills, con el kit del stack del proyecto.

Sandbox y producción

Podés tener las dos cuentas conectadas y elegir con cuál trabajar:

terminal

npx talo-hub login              # sandbox
npx talo-hub login --production # plata real
npx talo-hub use sandbox
npx talo-hub payments list --production

Salida y códigos

Con --json, el resultado sale en JSON por stdout y los mensajes para personas por stderr. Sale con 0 si salió bien y con 1 ante cualquier error, incluido doctor cuando falta algo y webhooks test cuando tu endpoint no respondió 2xx. Los errores en JSON traen { error: { code, message, status } }.

En CI y agentes

Sin login interactivo: pasá la key por variable de entorno. Con --json, la salida queda lista para procesar.

Si un agente corre el login, el comando mismo le avisa: espera a que autorices y termina solo (código 0 = conectada), así que no tiene que preguntarte si ya autorizaste. Lo corre en segundo plano si su herramienta le avisa cuando termina (Claude Code lo hace); si no, en primer plano con un timeout de 10 minutos o más. Si se corta, vuelve a correr npx talo-hub login y retoma el mismo login, con el mismo link y el mismo código. Si venció, correrlo de nuevo revisa una vez si igual terminaste en Talo (y se lleva la key); si no, empieza un login nuevo, con otro link y otro código. TALO_HUB_NO_BROWSER=1 evita que abra el navegador.

terminal

TALO_HUB_API_KEY=tph_test_… npx talo-hub payments create --amount 1000 --json