Badgie CLI : gérez votre club depuis le terminal
L'outil officiel en ligne de commande de Badgie : installation avec npm, connexion, chat avec l'agent du club, commandes /, mode commande avec --json pour les scripts et les agents, et mises à jour.
6 min de lectureAvancéMis à jour le 2 octobre 2026
Réponse rapide
Badgie CLI (@badgie/cli) est l'outil officiel en ligne de commande de Badgie : « le sport, dans votre terminal ». Il s'installe avec npm i -g @badgie/cli (ou s'essaie avec npx @badgie/cli), s'autorise avec badgie login et permet de parler à l'agent de votre club ou d'exécuter des outils depuis le terminal, toujours avec votre rôle. Chaque commande accepte --json pour les scripts et les agents IA. Il nécessite Node.js 20 ou plus.
Dans ce guide
Où le trouver
- 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.
Commandes
badgieoubadgie 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.
Pas à pas
- Installez le CLI :
npm i -g @badgie/cli(ou utiliseznpx @badgie/clisans installer). - Connectez-vous :
badgie login. Le navigateur s'ouvre, vous entrez avec votre compte Badgie et approuvez l'accès. - Vérifiez qui vous êtes :
badgie whoami. - Voyez ce que vous pouvez faire :
badgie tools. Le catalogue dépend de votre rôle. - 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. - Ou tapez simplement
badgieet 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. »
Dans le chat
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),/bienet/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,/logoutet/salir.
C'est le même agent que dans le tableau de bord et l'app, avec les mêmes crédits du club.
Pour les scripts et les agents IA
- Ajoutez
--jsonàwhoami,tools,runouupdatepour 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) etBADGIE_REGISTRY(registre npm alternatif). badgie updateutilise le gestionnaire avec lequel vous l'avez installé.
Exemples par rôle
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) etbadgie run list_my_proposals(état de vos propositions). - Entraîneur :
badgie run my_classes_today,badgie run my_students,award_badgepour attribuer des badges etrecord_attendancepour faire l'appel. - Élève ou famille :
badgie run my_badges,badgie run my_schedule,badgie run my_paymentsetbadgie run my_golf_stats.
Questions fréquentes
Est-ce sûr ?
Oui. Vous autorisez avec votre compte dans le navigateur (OAuth 2.1) et le CLI ne voit jamais votre mot de passe. Il agit avec votre rôle, ne voit jamais les données d'une autre école, et ce qui est envoyé aux familles ou publié attend votre approbation. badgie logout supprime les jetons locaux.
Convient-il aux agents IA et aux scripts ?
Oui. --json fournit une sortie stable pour des agents comme OpenClaw ou Claude Code, les pipelines de CI et les tâches planifiées.
Faut-il savoir programmer ?
Pas pour le chat : il suffit de taper badgie et de discuter. run et --json servent à automatiser.
Existe-t-il une API REST publique à la place du CLI ?
Non. Badgie ne propose ni API REST publique avec clés ni webhooks sortants. La voie pour les développeurs est le serveur MCP et Badgie CLI.
Consomme-t-il des crédits ?
Le chat avec l'agent consomme des crédits du club, comme dans le tableau de bord (/creditos affiche le solde). run et repl exécutent des outils sans passer par l'agent.