Salta al contenuto principale

Hai ancora dubbi su cosa può fare Badgie per il tuo club? Ci vediamo in una demo.

Badgie

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

Badgie CLI: gestisci il tuo club dal terminale

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
  1. Dove si trova
  2. Comandi
  3. Passo dopo passo
  4. Dentro la chat
  5. Per script e agenti IA
  6. Esempi per ruolo
  7. Domande frequenti

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

  • badgie o badgie 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.
Output reale del comando npx @badgie/cli --help
Output reale di `npx @badgie/cli --help` (versione 1.5.5).

Passo dopo passo

  1. Installa il CLI: npm i -g @badgie/cli (oppure usa npx @badgie/cli senza installare).
  2. Accedi: badgie login. Si apre il browser, entri con il tuo account Badgie e approvi l'accesso.
  3. Verifica chi sei: badgie whoami.
  4. Guarda cosa puoi fare: badgie tools. Il catalogo dipende dal tuo ruolo.
  5. 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.
  6. Oppure scrivi semplicemente badgie e 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.»

Output reale di npx @badgie/cli tools senza sessione e di badgie run --help
Senza sessione, `tools` chiede `badgie login`. `run --help` mostra gli argomenti chiave=valore e le opzioni `--json` e `--args`.

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), /bien e /mal [cosa non va] per valutare l'ultima risposta, /nuevo, /creditos, /whoami, /tools [filtro], /run <tool> k=v… (senza agente), /limpiar, /ayuda, /logout e /salir.

È lo stesso agente che hai nel pannello e nell'app, con gli stessi crediti del club.

Elenco reale dei comandi della chat di Badgie CLI
Comandi della chat secondo l'aiuto reale del CLI.

Per script e agenti IA

  • Aggiungi --json a whoami, tools, run o update per 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) e BADGIE_REGISTRY (registro npm alternativo).
  • badgie update usa 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) e badgie run list_my_proposals (stato delle tue proposte).
  • Istruttore: badgie run my_classes_today, badgie run my_students, award_badge per assegnare badge e record_attendance per fare l'appello.
  • Allievo o famiglia: badgie run my_badges, badgie run my_schedule, badgie run my_payments e badgie 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.

Continua a leggere

Guide correlate