Aller au contenu principal
ÂżAĂșn no gestionas tu club con Badgie? PruĂ©balo 30 dĂ­as gratis
Badgie CLI · @badgie/cli

Tu club, desde la terminal

Escribe badgie y habla con el agente de tu club: cuotas, asistencia, insignias, reservas y golf. Y para tus scripts y tus agentes, cada acciĂłn en un comando con salida --json.

badgie — Club Natación Delta

★ Badgie v1.5.5

Hola, Marta · Club Natación Delta
Cuenta de escuela

â€ș ÂżquiĂ©n nos debe cuotas este mes?

âș get_top_debtors(month: "2026-10")

⎿ 3 filas

âș

Tienes 4 recibos pendientes de 3 familias (236 € en total): LucĂ­a GarcĂ­a BenjamĂ­n A 2 recibos 118 € Marco Ruiz AlevĂ­n B 1 recibo 59 € InĂ©s Pardo Infantil 1 recibo 59 € ÂżLes preparo un recordatorio por WhatsApp?

â€ș Pregunta por tu club


Demo con datos de ejemplo de @badgie/cli: lo que ves es lo que imprime la terminal.

CĂłmo funciona

Instala, entra y pregunta.

El CLI es un cliente del servidor MCP oficial de Badgie: la misma cuenta, la misma seguridad por rol y el mismo catĂĄlogo de acciones. Solo cambia desde dĂłnde trabajas.

$ npm i -g @badgie/cli
1

Instala

Un paquete de npm. Funciona en macOS, Linux y Windows con Node.js.

$ badgie login
✓ Sesión iniciada — Marta
  Cuenta de escuela
2

Entra con tu cuenta

Se abre tu navegador, entras en Badgie y autorizas. Sin contraseñas en la terminal.

$ badgie
â€ș ÂżquiĂ©n falta hoy en alevĂ­n B?
3

Habla con tu club

El comando badgie abre el agente de tu club. Pregunta en lenguaje natural; lo sensible te lo propone.

badgie

El agente, en la terminal

Conversa con tu club: consulta, cruza datos y te propone cambios que apruebas con ↑↓ y Enter. Escribe / para ver los atajos.

badgie run

Comandos sueltos

Ejecuta cualquier herramienta de tu rol en una lĂ­nea. Las lecturas devuelven datos; las escrituras se proponen.

badgie tools

Lo que puedes hacer

Lista las herramientas de tu rol, con filtro. Para la direcciĂłn, mĂĄs de 180 consultas y acciones.

badgie update

Siempre al dĂ­a

Se actualiza con el gestor con el que lo instalaste, y te avisa cuando hay versiĂłn nueva. Nunca ensucia una salida --json.

Para agentes

Tu agente ya sabe usarlo.

Cada acciĂłn admite --json. Si tu agente sabe ejecutar comandos, ya sabe operar Badgie. OpenClaw, Claude Code, un cron o un pipeline de CI: sin SDK y sin integraciĂłn, la terminal es la interfaz.

  • Salida estructurada y cĂłdigos de salida honestos: fĂĄcil de leer, 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, una persona aprueba.
$ badgie run get_top_debtors --json | jq '.rows[0]'
{
  "student": "LucĂ­a GarcĂ­a",
  "pending_invoices": 2,
  "debt_eur": 118.0
}

$ badgie update --check --json | jq '.updateAvailable'
false
Seguridad

Datos de menores y de clubes. AsĂ­ de en serio.

La terminal no tiene atajos: pasa por las mismas reglas que el dashboard y que el MCP.

Aislado por escuela

Cada conexiĂłn ve y toca solo los datos de su cuenta. Un token de una escuela nunca alcanza los de otra, ni forzando filtros.

Tu rol, decidido por Badgie

Escuela, profesor o alumno se determina en el servidor a partir de tu cuenta real, nunca de lo que diga el cliente. Hereda tus permisos, ni uno mĂĄs.

TĂș apruebas lo sensible

Los cambios importantes no se ejecutan solos: llegan como propuesta a tu dashboard y tĂș decides. Los datos de menores siempre pasan por una persona.

Todo queda registrado

Cada consulta y cada cambio quedan en la bitĂĄcora. Puedes revocar el acceso cuando quieras desde tu cuenta.

Instalar

Dos comandos. Un minuto.

Requiere Node.js. Instala el paquete, entra con tu cuenta y la terminal ya habla Badgie con tu rol.

npm i -g @badgie/cli
$ badgie login   # abre tu navegador para autorizar
$ badgie         # abre el agente de tu club
$ badgie repl    # o el REPL clĂĄsico, sin agente

Primeros comandos, segĂșn quiĂ©n eres

Como cuenta de escuela lees todo el club y propones cambios que apruebas tĂș:

$ badgie run get_top_debtors
$ badgie run query_data table=student
$ badgie run list_action_catalog   # lo que puedes proponer
Esquiadores de una escuela que gestiona con Badgie
ÂżAĂșn no gestionas tu club con Badgie?

Todo tu club, en una lĂ­nea

Prueba Badgie 30 dĂ­as gratis, con todo incluido y sin tarjeta. Instala el CLI el primer dĂ­a.