Caricamento...
Stiamo preparando la tua destinazione. Questo richiederà solo un momento.
Se questo richiede più tempo del previsto, ti preghiamo di aggiornare la pagina.
Badgie CLICódigo abierto en npm · badgieEl 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.
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