Badgie CLI: opera tu club desde la terminal
La herramienta oficial de línea de comandos de Badgie: instalación con npm, inicio de sesión, chat con el agente del club, comandos /, modo comando con --json para scripts y agentes, y actualización.
6 min de lecturaAvanzadoActualizada el 2 de octubre de 2026
Respuesta rápida
Badgie CLI (@badgie/cli) es la herramienta oficial de línea de comandos de Badgie: «El deporte, en tu terminal». Se instala con npm i -g @badgie/cli (o se prueba con npx @badgie/cli), se autoriza con badgie login y permite hablar con el agente de tu club o ejecutar herramientas desde la terminal, siempre con tu rol. Todo comando admite --json para scripts y agentes de IA. Necesita Node.js 20 o superior.
En esta guía
Dónde está
- 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.
Comandos
badgieobadgie 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.
Paso a paso
- Instala el CLI:
npm i -g @badgie/cli(o usanpx @badgie/clisin instalar). - Inicia sesión:
badgie login. Se abre el navegador, entras con tu cuenta de Badgie y apruebas el acceso. - Comprueba quién eres:
badgie whoami. - Mira qué puedes hacer:
badgie tools. El catálogo depende de tu rol. - 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. - O escribe simplemente
badgiey 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.»
Dentro del chat
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),/bieny/mal [qué falló]para valorar la última respuesta,/nuevo,/creditos,/whoami,/tools [filtro],/run <tool> k=v…(sin el agente),/limpiar,/ayuda,/logouty/salir.
Es el mismo agente que tienes en el panel y en la app, con los mismos créditos del club.
Para scripts y agentes de IA
- Añade
--jsonawhoami,tools,runoupdatepara 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) yBADGIE_REGISTRY(registro npm alternativo). badgie updateusa el gestor con el que lo instalaste.
Ejemplos por rol
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) ybadgie run list_my_proposals(estado de tus propuestas). - Profesor:
badgie run my_classes_today,badgie run my_students,award_badgepara conceder insignias yrecord_attendancepara pasar lista. - Alumno o familia:
badgie run my_badges,badgie run my_schedule,badgie run my_paymentsybadgie run my_golf_stats.
Preguntas frecuentes
¿Es seguro?
Sí. Autorizas con tu cuenta en el navegador (OAuth 2.1) y el CLI nunca ve tu contraseña. Actúa con tu rol, nunca ve datos de otra escuela y lo que se envía a familias o se publica espera tu aprobación. badgie logout borra los tokens locales.
¿Sirve para agentes de IA y scripts?
Sí. --json da salida estable para agentes como OpenClaw o Claude Code, pipelines de CI y tareas programadas.
¿Necesito saber programar?
No para el chat: basta con escribir badgie y conversar. run y --json son para quien quiera automatizar.
¿Hay una API REST pública en lugar del CLI?
No. Badgie no ofrece una API REST pública con claves ni webhooks salientes. La vía para desarrolladores es el servidor MCP y Badgie CLI.
¿Gasta créditos?
El chat con el agente consume créditos del club, igual que en el panel (/creditos muestra el saldo). run y repl ejecutan herramientas sin pasar por el agente.