Badgie CLI: opera el teu club des del terminal

• Paquet npm: @badgie/cli (versió 1.5.5 a l'octubre de 2026). Ordre: badgie.
• Funciona en qualsevol sistema amb Node.js 20 o superior (macOS, Linux i Windows).
• És un client del servidor MCP de Badgie: mateixes eines, mateix inici de sessió amb el teu compte i mateixa Delegació.
• Els missatges del CLI són en castellà.

• badgie o badgie chat: parla amb l'agent del teu club.
• badgie login: inicia sessió amb el teu compte de Badgie (s'obre el navegador).
• badgie logout: tanca la sessió i esborra els tokens locals.
• badgie whoami [--json]: mostra el teu rol i la teva escola.
• badgie tools [filtre] [--json]: llista el que pots fer (les eines del teu rol).
• badgie run <eina> [clau=valor…] [--args '<json>'] [--json]: executa una eina. Les lectures retornen dades; les escriptures segueixen la Delegació del club.
• badgie update [--check] [--json] [--channel <dist-tag>]: actualitza el CLI a la darrera versió publicada.
• badgie repl: el REPL clàssic d'eines, sense agent.

1. Instal·la el CLI: npm i -g @badgie/cli (o fes servir npx @badgie/cli sense instal·lar).
2. Inicia sessió: badgie login. S'obre el navegador, entres amb el teu compte de Badgie i aproves l'accés.
3. Comprova qui ets: badgie whoami.
4. Mira què pots fer: badgie tools. El catàleg depèn del teu rol.
5. Executa una eina, per exemple badgie run get_top_debtors limit=10. Per a arguments niats fes servir notació amb punt (payload.student_id=…) o passa el JSON complet amb --args.
6. O escriu simplement badgie i conversa amb l'agent del teu club.

Sense sessió, les ordres que necessiten el teu compte ho indiquen: «No has iniciado sesión. Ejecuta badgie login.»

Escriu / i prem Tab o → per completar. Cada rol veu els seus.

• Club: /hoy (classes, llistes sense passar, avisos), /semana, /pendientes (propostes esperant el teu OK), /deudores, /alumno <nom>, /insignias, /asistencia [grup], /leads, /mensaje <a qui> <què> (redacta i proposa un enviament), /cantera (equips, partits i resultats), /swing [alumne], /informe <tema>, /recuerda <fet> i /memoria.
• Sessió: /model [nivell] (ràpid, equilibrat o màxim), /bien i /mal [què ha fallat] per valorar la darrera resposta, /nuevo, /creditos, /whoami, /tools [filtre], /run <tool> k=v… (sense l'agent), /limpiar, /ayuda, /logout i /salir.

És el mateix agent que tens al panell i a l'app, amb els mateixos crèdits del club.

• Afegeix --json a whoami, tools, run o update per obtenir sortida JSON pensada per a agents i scripts.
• Per mantenir el CLI al dia sense intervenció: badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json.
• Variables d'entorn: BADGIE_NO_UPDATE_NOTIFIER=1 (silencia l'avís de versió nova), BADGIE_DISABLE_UPDATES=1 (impedeix actualitzar), BADGIE_UPDATE_CHANNEL (canal, per defecte latest) i BADGIE_REGISTRY (registre npm alternatiu).
• badgie update fa servir el gestor amb què el vas instal·lar.

El rol no es tria: surt del teu compte de Badgie.

• Compte d'escola: badgie run get_top_debtors, badgie run list_action_catalog (accions que pots proposar) i badgie run list_my_proposals (estat de les teves propostes).
• Professor: badgie run my_classes_today, badgie run my_students, award_badge per concedir insígnies i record_attendance per passar llista.
• Alumne o família: badgie run my_badges, badgie run my_schedule, badgie run my_payments i badgie run my_golf_stats.