Chargement...
Nous préparons votre destination. Cela ne prendra qu'un instant.
Si cela prend plus de temps que prévu, veuillez rafraßchir la page.
Vous vous demandez encore ce que Badgie peut faire pour votre club ? Rendez-vous en démo.
Badgie CLI · código abierto en npmEl deporte,
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.
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'
51Seguridad 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 REPLPrimeros 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 dashboardComo profesor operas tus clases y tus alumnos, sin abrir la app:
$ badgie run my_classes_today
$ badgie run record_attendance
$ badgie run award_badgeComo alumno o familia consultas tu propia actividad, y solo la tuya:
$ badgie run my_badges
$ badgie run my_schedule
$ badgie run my_golf_stats