Badgie CLI: gestisci il tuo club dal terminale
Lo strumento ufficiale a riga di comando di Badgie: installazione con npm, accesso, chat con l'agente del club, comandi /, modalità comando con --json per script e agenti, e aggiornamento.
6 min di letturaAvanzatoAggiornata il 2 ottobre 2026
Risposta rapida
Badgie CLI (@badgie/cli) è lo strumento ufficiale a riga di comando di Badgie: «lo sport, nel tuo terminale». Si installa con npm i -g @badgie/cli (o si prova con npx @badgie/cli), si autorizza con badgie login e permette di parlare con l'agente del tuo club o eseguire strumenti dal terminale, sempre con il tuo ruolo. Ogni comando accetta --json per script e agenti IA. Richiede Node.js 20 o superiore.
In questa guida
Dove si trova
- Pacchetto npm:
@badgie/cli(versione 1.5.5 a ottobre 2026). Comando:badgie. - Funziona su qualsiasi sistema con Node.js 20 o superiore (macOS, Linux e Windows).
- È un client del server MCP di Badgie: stessi strumenti, stesso accesso con il tuo account e stessa Delega.
- I messaggi del CLI sono in spagnolo.
Comandi
badgieobadgie chat: parla con l'agente del tuo club.badgie login: accedi con il tuo account Badgie (si apre il browser).badgie logout: chiude la sessione e cancella i token locali.badgie whoami [--json]: mostra il tuo ruolo e la tua scuola.badgie tools [filtro] [--json]: elenca ciò che puoi fare (gli strumenti del tuo ruolo).badgie run <strumento> [chiave=valore…] [--args '<json>'] [--json]: esegue uno strumento. Le letture restituiscono dati; le scritture seguono la Delega del club.badgie update [--check] [--json] [--channel <dist-tag>]: aggiorna il CLI all'ultima versione pubblicata.badgie repl: il REPL classico degli strumenti, senza agente.
Passo dopo passo
- Installa il CLI:
npm i -g @badgie/cli(oppure usanpx @badgie/clisenza installare). - Accedi:
badgie login. Si apre il browser, entri con il tuo account Badgie e approvi l'accesso. - Verifica chi sei:
badgie whoami. - Guarda cosa puoi fare:
badgie tools. Il catalogo dipende dal tuo ruolo. - Esegui uno strumento, per esempio
badgie run get_top_debtors limit=10. Per argomenti annidati usa la notazione con il punto (payload.student_id=…) o passa il JSON completo con--args. - Oppure scrivi semplicemente
badgiee conversa con l'agente del tuo club.
Senza sessione, i comandi che richiedono il tuo account lo segnalano: «No has iniciado sesión. Ejecuta badgie login.»
Dentro la chat
Scrivi / e premi Tab o → per completare. Ogni ruolo vede i propri.
- Club:
/hoy(classi, appelli non fatti, avvisi),/semana,/pendientes(proposte in attesa del tuo OK),/deudores,/alumno <nome>,/insignias,/asistencia [gruppo],/leads,/mensaje <a chi> <cosa>(redige e propone un invio),/cantera(squadre, partite e risultati),/swing [allievo],/informe <tema>,/recuerda <fatto>e/memoria. - Sessione:
/model [livello](rapido, bilanciato o massimo),/biene/mal [cosa non va]per valutare l'ultima risposta,/nuevo,/creditos,/whoami,/tools [filtro],/run <tool> k=v…(senza agente),/limpiar,/ayuda,/logoute/salir.
È lo stesso agente che hai nel pannello e nell'app, con gli stessi crediti del club.
Per script e agenti IA
- Aggiungi
--jsonawhoami,tools,runoupdateper ottenere output JSON pensato per agenti e script. - Per tenere il CLI aggiornato senza intervento:
badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json. - Variabili d'ambiente:
BADGIE_NO_UPDATE_NOTIFIER=1(silenzia l'avviso di nuova versione),BADGIE_DISABLE_UPDATES=1(impedisce l'aggiornamento),BADGIE_UPDATE_CHANNEL(canale, latest di default) eBADGIE_REGISTRY(registro npm alternativo). badgie updateusa il gestore con cui l'hai installato.
Esempi per ruolo
Il ruolo non si sceglie: deriva dal tuo account Badgie.
- Account scuola:
badgie run get_top_debtors,badgie run list_action_catalog(azioni che puoi proporre) ebadgie run list_my_proposals(stato delle tue proposte). - Istruttore:
badgie run my_classes_today,badgie run my_students,award_badgeper assegnare badge erecord_attendanceper fare l'appello. - Allievo o famiglia:
badgie run my_badges,badgie run my_schedule,badgie run my_paymentsebadgie run my_golf_stats.
Domande frequenti
È sicuro?
Sì. Autorizzi con il tuo account nel browser (OAuth 2.1) e il CLI non vede mai la tua password. Agisce con il tuo ruolo, non vede mai i dati di un'altra scuola e ciò che si invia alle famiglie o si pubblica attende la tua approvazione. badgie logout cancella i token locali.
Va bene per agenti IA e script?
Sì. --json fornisce un output stabile per agenti come OpenClaw o Claude Code, pipeline di CI e attività pianificate.
Devo saper programmare?
Non per la chat: basta scrivere badgie e conversare. run e --json sono per chi vuole automatizzare.
C'è un'API REST pubblica al posto del CLI?
No. Badgie non offre un'API REST pubblica con chiavi né webhook in uscita. La via per gli sviluppatori è il server MCP e Badgie CLI.
Consuma crediti?
La chat con l'agente consuma crediti del club, come nel pannello (/creditos mostra il saldo). run e repl eseguono strumenti senza passare dall'agente.