Salta al contingut principal
¿Aún no gestionas tu club con Badgie? Pruébalo 30 días gratis
Badgie CLI · @badgie/cli

Tu club, desde la terminal

Escribe badgie y habla con el agente de tu club: cuotas, asistencia, insignias, reservas y golf. Y para tus scripts y tus agentes, cada acción en un comando con salida --json.

badgie — Club Natación Delta

★ Badgie v1.5.5

Hola, Marta · Club Natación Delta
Cuenta de escuela

› ¿quién nos debe cuotas este mes?

⏺ get_top_debtors(month: "2026-10")

⎿ 3 filas

⏺

Tienes 4 recibos pendientes de 3 familias (236 € en total): Lucía García Benjamín A 2 recibos 118 € Marco Ruiz Alevín B 1 recibo 59 € Inés Pardo Infantil 1 recibo 59 € ¿Les preparo un recordatorio por WhatsApp?

› Pregunta por tu club…

Demo con datos de ejemplo de @badgie/cli: lo que ves es lo que imprime la terminal.

Cómo funciona

Instala, entra y pregunta.

El CLI es un cliente del servidor MCP oficial de Badgie: la misma cuenta, la misma seguridad por rol y el mismo catálogo de acciones. Solo cambia desde dónde trabajas.

$ npm i -g @badgie/cli
1

Instala

Un paquete de npm. Funciona en macOS, Linux y Windows con Node.js.

$ badgie login
✓ Sesión iniciada — Marta
  Cuenta de escuela
2

Entra con tu cuenta

Se abre tu navegador, entras en Badgie y autorizas. Sin contraseñas en la terminal.

$ badgie
› ¿quién falta hoy en alevín B?
3

Habla con tu club

El comando badgie abre el agente de tu club. Pregunta en lenguaje natural; lo sensible te lo propone.

badgie

El agente, en la terminal

Conversa con tu club: consulta, cruza datos y te propone cambios que apruebas con ↑↓ y Enter. Escribe / para ver los atajos.

badgie run

Comandos sueltos

Ejecuta cualquier herramienta de tu rol en una línea. Las lecturas devuelven datos; las escrituras se proponen.

badgie tools

Lo que puedes hacer

Lista las herramientas de tu rol, con filtro. Para la dirección, más de 180 consultas y acciones.

badgie update

Siempre al día

Se actualiza con el gestor con el que lo instalaste, y te avisa cuando hay versión nueva. Nunca ensucia una salida --json.

Para agentes

Tu agente ya sabe usarlo.

Cada acción admite --json. Si tu agente sabe ejecutar comandos, ya sabe operar Badgie. OpenClaw, Claude Code, un cron o un pipeline de CI: sin SDK y sin integración, la terminal es la interfaz.

  • Salida estructurada y códigos de salida honestos: fácil de leer, fácil de reintentar.
  • El agente hereda el rol de la cuenta que autorizó: mismo aislamiento, mismos permisos.
  • Las escrituras sensibles siguen siendo propuestas: el agente propone, una persona aprueba.
$ badgie run get_top_debtors --json | jq '.rows[0]'
{
  "student": "Lucía García",
  "pending_invoices": 2,
  "debt_eur": 118.0
}

$ badgie update --check --json | jq '.updateAvailable'
false
Seguridad

Datos de menores y de clubes. Así de en serio.

La terminal no tiene atajos: pasa por las mismas reglas que el dashboard y que el MCP.

Aislado por escuela

Cada conexión ve y toca solo los datos de su cuenta. Un token de una escuela nunca alcanza los de otra, ni forzando filtros.

Tu rol, decidido por Badgie

Escuela, profesor o alumno se determina en el servidor a partir de tu cuenta real, nunca de lo que diga el cliente. Hereda tus permisos, ni uno más.

Tú apruebas lo sensible

Los cambios importantes no se ejecutan solos: llegan como propuesta a tu dashboard y tú decides. Los datos de menores siempre pasan por una persona.

Todo queda registrado

Cada consulta y cada cambio quedan en la bitácora. Puedes revocar el acceso cuando quieras desde tu cuenta.

Instalar

Dos comandos. Un minuto.

Requiere Node.js. Instala el paquete, entra con tu cuenta y la terminal ya habla Badgie con tu rol.

npm i -g @badgie/cli
$ badgie login   # abre tu navegador para autorizar
$ badgie         # abre el agente de tu club
$ badgie repl    # o el REPL clásico, sin agente

Primeros comandos, según quién eres

Como cuenta de escuela lees todo el club y propones cambios que apruebas tú:

$ badgie run get_top_debtors
$ badgie run query_data table=student
$ badgie run list_action_catalog   # lo que puedes proponer
Esquiadores de una escuela que gestiona con Badgie
¿Aún no gestionas tu club con Badgie?

Todo tu club, en una línea

Prueba Badgie 30 días gratis, con todo incluido y sin tarjeta. Instala el CLI el primer día.