Badgie CLI: opera el teu club des del terminal
L'eina oficial de línia d'ordres de Badgie: instal·lació amb npm, inici de sessió, xat amb l'agent del club, ordres /, mode ordre amb --json per a scripts i agents, i actualització.
6 min de lecturaAvançatActualitzada el 2 d’octubre del 2026
Resposta ràpida
Badgie CLI (@badgie/cli) és l'eina oficial de línia d'ordres de Badgie: «l'esport, al teu terminal». S'instal·la amb npm i -g @badgie/cli (o es prova amb npx @badgie/cli), s'autoritza amb badgie login i permet parlar amb l'agent del teu club o executar eines des del terminal, sempre amb el teu rol. Totes les ordres admeten --json per a scripts i agents d'IA. Necessita Node.js 20 o superior.
En aquesta guia
On és
- 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à.
Ordres
badgieobadgie 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.
Pas a pas
- Instal·la el CLI:
npm i -g @badgie/cli(o fes servirnpx @badgie/clisense instal·lar). - Inicia sessió:
badgie login. S'obre el navegador, entres amb el teu compte de Badgie i aproves l'accés. - Comprova qui ets:
badgie whoami. - Mira què pots fer:
badgie tools. El catàleg depèn del teu rol. - 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. - O escriu simplement
badgiei 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.»
Dins del xat
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),/bieni/mal [què ha fallat]per valorar la darrera resposta,/nuevo,/creditos,/whoami,/tools [filtre],/run <tool> k=v…(sense l'agent),/limpiar,/ayuda,/logouti/salir.
És el mateix agent que tens al panell i a l'app, amb els mateixos crèdits del club.
Per a scripts i agents d'IA
- Afegeix
--jsonawhoami,tools,runoupdateper 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) iBADGIE_REGISTRY(registre npm alternatiu). badgie updatefa servir el gestor amb què el vas instal·lar.
Exemples per rol
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) ibadgie run list_my_proposals(estat de les teves propostes). - Professor:
badgie run my_classes_today,badgie run my_students,award_badgeper concedir insígnies irecord_attendanceper passar llista. - Alumne o família:
badgie run my_badges,badgie run my_schedule,badgie run my_paymentsibadgie run my_golf_stats.
Preguntes freqüents
És segur?
Sí. Autoritzes amb el teu compte al navegador (OAuth 2.1) i el CLI mai veu la teva contrasenya. Actua amb el teu rol, mai veu dades d'una altra escola i el que s'envia a famílies o es publica espera la teva aprovació. badgie logout esborra els tokens locals.
Serveix per a agents d'IA i scripts?
Sí. --json dona una sortida estable per a agents com OpenClaw o Claude Code, pipelines de CI i tasques programades.
He de saber programar?
No per al xat: n'hi ha prou d'escriure badgie i conversar. run i --json són per a qui vulgui automatitzar.
Hi ha una API REST pública en lloc del CLI?
No. Badgie no ofereix una API REST pública amb claus ni webhooks de sortida. La via per a desenvolupadors és el servidor MCP i Badgie CLI.
Gasta crèdits?
El xat amb l'agent consumeix crèdits del club, igual que al panell (/creditos mostra el saldo). run i repl executen eines sense passar per l'agent.