Saltar al contenido principal

¿Todavía tienes dudas de lo que Badgie hace por tu club? Nos vemos en una demo.

Badgie
Badgie CLI · código abierto en npm

El deporte,
en tu terminal.

La línea de comandos oficial de Badgie. Instala, autoriza con tu cuenta y opera tu escuela, club o academia desde la terminal: alumnos, insignias, clases, finanzas, reservas y golf. Para humanos, un REPL. Para agentes, --json.

npm i -g @badgie/cliCómo funciona
badgie — zsh

$ npm i -g @badgie/cli

$ badgie

➜ conectado como Cuenta de escuela · RFEG Madrid de Golf

➜ 51 herramientas disponibles para tu rol

badgie ▸

Qué es

Un harness de terminal sobre el Badgie MCP.

El CLI es un cliente del servidor MCP oficial de Badgie: reutiliza su autenticación, su seguridad por rol y su catálogo de ~180 acciones y consultas. Lo que cambia es el sitio desde donde trabajas.

REPL interactivo

Arranca badgie y trabaja en sesión: whoami para ver tu rol y escuela, tools para listar lo que puedes hacer, run para ejecutar. Todo filtrado por tu rol real.

Consultas al instante

query_data lee cualquier dato de tu escuela desde la terminal: deuda, asistencia, ocupación, progreso de insignias. Sin abrir el navegador.

Modo comando

Cada acción funciona también como comando suelto con salida --json: perfecto para scripts, cron jobs, CI y agentes que operan tu escuela por ti.

Siempre al día

badgie update actualiza el CLI con el gestor con el que lo instalaste, y el propio CLI te avisa cuando hay versión nueva. El aviso va por stderr y nunca ensucia una salida --json.

Cómo funciona

Autoriza una vez. Opera con tu rol.

01

badgie login

El CLI abre tu navegador y te lleva al inicio de sesión de Badgie. Apruebas el acceso vía OAuth 2.1 —el mismo estándar de «Iniciar sesión con»—. No compartes contraseñas.

02

Badgie reconoce tu rol

Escuela, profesor o alumno: tu rol y tu alcance se derivan de tu cuenta real en el servidor. La terminal hereda tus permisos exactos, y la seguridad de datos de Badgie aplica sola.

03

Operas desde la terminal

Consulta datos al instante con run y query_data. Para cambiar algo importante, el CLI lo registra como propuesta y tú lo apruebas en el dashboard.

Una terminal por rol

Cada persona, su sesión. Cada sesión, su propio alcance.

Cuenta de escuela

El director

Todo el negocio, consultable y operable sin salir de la terminal.

  • Consultar cualquier dato: deuda por alumno, asistencia, riesgo de abandono, MRR, ocupación de reservas.
  • Proponer cambios (mover un lead, otorgar una insignia, publicar un post) que se ejecutan solo con tu visto bueno en el dashboard.
  • Cruzar módulos: insignias, clases, finanzas, torneos, golf y más de veinte deportes.
Profesor

El entrenador

Tu día a día en clase, en comandos de una línea.

  • Pasar lista de la sesión de hoy sin abrir la app.
  • Conceder insignias a tus alumnos y dejar notas de entrenamiento.
  • Revisar el progreso e informes de los alumnos que llevas.
Alumno y familia

La familia

Tu propia actividad, y solo la tuya.

  • Ver insignias, horario, asistencia, informes y pagos.
  • Seguir tus rondas, estadísticas y logros de golf.
  • Registrar tu check-in diario de nutrición.
Para agentes

--json y a correr.

Todo comando admite salida JSON estructurada. Si tu agente —OpenClaw, Claude Code, un cron, un pipeline de CI— sabe ejecutar comandos, ya sabe operar Badgie. Sin SDK, sin integración: la terminal es la interfaz.

  • Salida estructurada y códigos de salida honestos: fácil de parsear, 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, el humano aprueba.
$ badgie run get_top_debtors --json | jq '.rows[0]'
{
  "student": "Lucía G.",
  "pending_invoices": 2,
  "debt_eur": 118.0
}

$ badgie tools --json | jq 'length'
51
Seguridad primero

Datos de menores y de clubes. Nos lo tomamos así de en serio.

Aislado por escuela

Cada sesión ve y toca solo los datos de su cuenta. Un token de una escuela nunca alcanza los datos de otra, ni forzando filtros. Es un invariante verificado, no una promesa.

Tu rol, derivado del servidor

Escuela, profesor o alumno se determina en el servidor a partir de tu cuenta real —nunca de datos que el cliente pueda falsificar—. El CLI hereda tus permisos, ni uno más.

Humano en el bucle

Las escrituras sensibles no se ejecutan solas: badgie run las registra como propuesta y tú decides en tu dashboard. Los datos de menores siempre pasan por aprobación humana.

Todo queda registrado

Cada llamada se audita y cada cambio queda en la bitácora. Puedes cerrar sesión o revocar el acceso cuando quieras.

Instalar

Dos comandos. Un minuto.

Requiere Node.js. Instala el paquete, inicia sesión y la terminal ya habla Badgie con tu rol.

$ npm i -g @badgie/cli
$ badgie login   # abre tu navegador para autorizar
$ badgie         # arranca el REPL

Ver @badgie/cli en npm

Primeros comandos, según quién eres:

Como cuenta de escuela lees todo el negocio y propones acciones que apruebas en el dashboard:

$ badgie run get_top_debtors
$ badgie run query_data --table student --where "is_active=true"
$ badgie run propose_action --type award_badge  # llega a tu dashboard