Badgie CLI: opera tu club desde la terminal

• Paquete npm: @badgie/cli (versión 1.5.5 en octubre de 2026). Comando: badgie.
• Funciona en cualquier sistema con Node.js 20 o superior (macOS, Linux y Windows).
• Es un cliente del servidor MCP de Badgie: usa las mismas herramientas, el mismo inicio de sesión con tu cuenta y la misma Delegación.

• badgie o badgie chat: habla con el agente de tu club.
• badgie login: inicia sesión con tu cuenta Badgie (se abre el navegador).
• badgie logout: cierra la sesión y borra los tokens locales.
• badgie whoami [--json]: muestra tu rol y tu escuela.
• badgie tools [filtro] [--json]: lista lo que puedes hacer (las herramientas de tu rol).
• badgie run <herramienta> [clave=valor…] [--args '<json>'] [--json]: ejecuta una herramienta. Las lecturas devuelven datos; las escrituras siguen la Delegación de tu club.
• badgie update [--check] [--json] [--channel <dist-tag>]: actualiza el CLI a la última versión publicada.
• badgie repl: el REPL clásico de herramientas, sin agente.

1. Instala el CLI: npm i -g @badgie/cli (o usa npx @badgie/cli sin instalar).
2. Inicia sesión: badgie login. Se abre el navegador, entras con tu cuenta de Badgie y apruebas el acceso.
3. Comprueba quién eres: badgie whoami.
4. Mira qué puedes hacer: badgie tools. El catálogo depende de tu rol.
5. Ejecuta una herramienta, por ejemplo badgie run get_top_debtors limit=10. Para argumentos anidados usa notación con punto (payload.student_id=…) o pasa el JSON completo con --args.
6. O escribe simplemente badgie y conversa con el agente de tu club.

Sin sesión iniciada, los comandos que necesitan tu cuenta lo indican: «No has iniciado sesión. Ejecuta badgie login.»

Escribe / y pulsa Tab o → para completar. Cada rol ve los suyos.

• Club: /hoy (clases, listas sin pasar, avisos), /semana, /pendientes (propuestas esperando tu OK), /deudores, /alumno <nombre>, /insignias, /asistencia [grupo], /leads, /mensaje <a quién> <qué> (redacta y propone un envío), /cantera (equipos, partidos y resultados), /swing [alumno], /informe <tema>, /recuerda <hecho> y /memoria.
• Sesión: /model [nivel] (rápido, equilibrado o máximo), /bien y /mal [qué falló] para valorar la última respuesta, /nuevo, /creditos, /whoami, /tools [filtro], /run <tool> k=v… (sin el agente), /limpiar, /ayuda, /logout y /salir.

Es el mismo agente que tienes en el panel y en la app, con los mismos créditos del club.

• Añade --json a whoami, tools, run o update para obtener salida JSON pensada para agentes y scripts.
• Para mantener el CLI al día sin intervención: badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json.
• Variables de entorno: BADGIE_NO_UPDATE_NOTIFIER=1 (calla el aviso de versión nueva), BADGIE_DISABLE_UPDATES=1 (impide actualizar), BADGIE_UPDATE_CHANNEL (canal, por defecto latest) y BADGIE_REGISTRY (registro npm alternativo).
• badgie update usa el gestor con el que lo instalaste.

El rol no se elige: sale de tu cuenta Badgie.

• Cuenta de escuela: badgie run get_top_debtors, badgie run list_action_catalog (acciones que puedes proponer) y badgie run list_my_proposals (estado de tus propuestas).
• Profesor: badgie run my_classes_today, badgie run my_students, award_badge para conceder insignias y record_attendance para pasar lista.
• Alumno o familia: badgie run my_badges, badgie run my_schedule, badgie run my_payments y badgie run my_golf_stats.