Badgie CLI : gérez votre club depuis le terminal

• Paquet npm : @badgie/cli (version 1.5.5 en octobre 2026). Commande : badgie.
• Fonctionne sur tout système avec Node.js 20 ou plus (macOS, Linux et Windows).
• C'est un client du serveur MCP de Badgie : mêmes outils, même connexion avec votre compte et même Délégation.
• Les messages du CLI sont en espagnol.

• badgie ou badgie chat : parler à l'agent de votre club.
• badgie login : se connecter avec votre compte Badgie (le navigateur s'ouvre).
• badgie logout : fermer la session et supprimer les jetons locaux.
• badgie whoami [--json] : afficher votre rôle et votre école.
• badgie tools [filtre] [--json] : lister ce que vous pouvez faire (les outils de votre rôle).
• badgie run <outil> [clé=valeur…] [--args '<json>'] [--json] : exécuter un outil. Les lectures renvoient des données ; les écritures suivent la Délégation du club.
• badgie update [--check] [--json] [--channel <dist-tag>] : mettre à jour le CLI vers la dernière version publiée.
• badgie repl : le REPL classique des outils, sans agent.

1. Installez le CLI : npm i -g @badgie/cli (ou utilisez npx @badgie/cli sans installer).
2. Connectez-vous : badgie login. Le navigateur s'ouvre, vous entrez avec votre compte Badgie et approuvez l'accès.
3. Vérifiez qui vous êtes : badgie whoami.
4. Voyez ce que vous pouvez faire : badgie tools. Le catalogue dépend de votre rôle.
5. Exécutez un outil, par exemple badgie run get_top_debtors limit=10. Pour des arguments imbriqués, utilisez la notation pointée (payload.student_id=…) ou passez le JSON complet avec --args.
6. Ou tapez simplement badgie et discutez avec l'agent de votre club.

Sans session, les commandes qui ont besoin de votre compte l'indiquent : « No has iniciado sesión. Ejecuta badgie login. »

Tapez / puis Tab ou → pour compléter. Chaque rôle voit les siennes.

• Club : /hoy (cours, appels non faits, alertes), /semana, /pendientes (propositions en attente de votre accord), /deudores, /alumno <nom>, /insignias, /asistencia [groupe], /leads, /mensaje <à qui> <quoi> (rédige et propose un envoi), /cantera (équipes, matchs et résultats), /swing [élève], /informe <sujet>, /recuerda <fait> et /memoria.
• Session : /model [niveau] (rapide, équilibré ou maximal), /bien et /mal [ce qui n'a pas marché] pour noter la dernière réponse, /nuevo, /creditos, /whoami, /tools [filtre], /run <tool> k=v… (sans l'agent), /limpiar, /ayuda, /logout et /salir.

C'est le même agent que dans le tableau de bord et l'app, avec les mêmes crédits du club.

• Ajoutez --json à whoami, tools, run ou update pour une sortie JSON pensée pour les agents et les scripts.
• Pour garder le CLI à jour sans intervention : badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json.
• Variables d'environnement : BADGIE_NO_UPDATE_NOTIFIER=1 (coupe l'avis de nouvelle version), BADGIE_DISABLE_UPDATES=1 (empêche la mise à jour), BADGIE_UPDATE_CHANNEL (canal, latest par défaut) et BADGIE_REGISTRY (registre npm alternatif).
• badgie update utilise le gestionnaire avec lequel vous l'avez installé.

Le rôle ne se choisit pas : il découle de votre compte Badgie.

• Compte école : badgie run get_top_debtors, badgie run list_action_catalog (actions que vous pouvez proposer) et badgie run list_my_proposals (état de vos propositions).
• Entraîneur : badgie run my_classes_today, badgie run my_students, award_badge pour attribuer des badges et record_attendance pour faire l'appel.
• Élève ou famille : badgie run my_badges, badgie run my_schedule, badgie run my_payments et badgie run my_golf_stats.