Badgie CLI: gira o seu clube a partir do terminal
A ferramenta oficial de linha de comandos do Badgie: instalação com npm, início de sessão, chat com o agente do clube, comandos /, modo comando com --json para scripts e agentes, e atualização.
6 min de leituraAvançadoAtualizado em 2 de outubro de 2026
Resposta rápida
O Badgie CLI (@badgie/cli) é a ferramenta oficial de linha de comandos do Badgie: «o desporto, no seu terminal». Instala-se com npm i -g @badgie/cli (ou experimenta-se com npx @badgie/cli), autoriza-se com badgie login e permite falar com o agente do seu clube ou executar ferramentas no terminal, sempre com o seu papel. Todos os comandos aceitam --json para scripts e agentes de IA. Requer Node.js 20 ou superior.
Neste guia
Onde está
- Pacote npm:
@badgie/cli(versão 1.5.5 em outubro de 2026). Comando:badgie. - Funciona em qualquer sistema com Node.js 20 ou superior (macOS, Linux e Windows).
- É um cliente do servidor MCP do Badgie: as mesmas ferramentas, o mesmo início de sessão com a sua conta e a mesma Delegação.
- As mensagens do CLI estão em espanhol.
Comandos
badgieoubadgie chat: fale com o agente do seu clube.badgie login: inicie sessão com a sua conta Badgie (abre-se o navegador).badgie logout: termina a sessão e apaga os tokens locais.badgie whoami [--json]: mostra o seu papel e a sua escola.badgie tools [filtro] [--json]: lista o que pode fazer (as ferramentas do seu papel).badgie run <ferramenta> [chave=valor…] [--args '<json>'] [--json]: executa uma ferramenta. As leituras devolvem dados; as escritas seguem a Delegação do clube.badgie update [--check] [--json] [--channel <dist-tag>]: atualiza o CLI para a última versão publicada.badgie repl: o REPL clássico de ferramentas, sem agente.
Passo a passo
- Instale o CLI:
npm i -g @badgie/cli(ou usenpx @badgie/clisem instalar). - Inicie sessão:
badgie login. Abre-se o navegador, entra com a sua conta Badgie e aprova o acesso. - Confirme quem é:
badgie whoami. - Veja o que pode fazer:
badgie tools. O catálogo depende do seu papel. - Execute uma ferramenta, por exemplo
badgie run get_top_debtors limit=10. Para argumentos aninhados use notação com ponto (payload.student_id=…) ou passe o JSON completo com--args. - Ou escreva simplesmente
badgiee converse com o agente do seu clube.
Sem sessão, os comandos que precisam da sua conta avisam: «No has iniciado sesión. Ejecuta badgie login.»
Dentro do chat
Escreva / e carregue em Tab ou → para completar. Cada papel vê os seus.
- Clube:
/hoy(aulas, chamadas por fazer, avisos),/semana,/pendientes(propostas à espera do seu OK),/deudores,/alumno <nome>,/insignias,/asistencia [grupo],/leads,/mensaje <a quem> <o quê>(redige e propõe um envio),/cantera(equipas, jogos e resultados),/swing [aluno],/informe <tema>,/recuerda <facto>e/memoria. - Sessão:
/model [nível](rápido, equilibrado ou máximo),/biene/mal [o que falhou]para avaliar a última resposta,/nuevo,/creditos,/whoami,/tools [filtro],/run <tool> k=v…(sem o agente),/limpiar,/ayuda,/logoute/salir.
É o mesmo agente que tem no painel e na app, com os mesmos créditos do clube.
Para scripts e agentes de IA
- Junte
--jsonawhoami,tools,runouupdatepara obter saída JSON pensada para agentes e scripts. - Para manter o CLI atualizado sem intervenção:
badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json. - Variáveis de ambiente:
BADGIE_NO_UPDATE_NOTIFIER=1(silencia o aviso de nova versão),BADGIE_DISABLE_UPDATES=1(impede a atualização),BADGIE_UPDATE_CHANNEL(canal, latest por omissão) eBADGIE_REGISTRY(registo npm alternativo). badgie updateusa o gestor com que o instalou.
Exemplos por papel
O papel não se escolhe: vem da sua conta Badgie.
- Conta de escola:
badgie run get_top_debtors,badgie run list_action_catalog(ações que pode propor) ebadgie run list_my_proposals(estado das suas propostas). - Professor:
badgie run my_classes_today,badgie run my_students,award_badgepara atribuir insígnias erecord_attendancepara fazer a chamada. - Aluno ou família:
badgie run my_badges,badgie run my_schedule,badgie run my_paymentsebadgie run my_golf_stats.
Perguntas frequentes
É seguro?
Sim. Autoriza com a sua conta no navegador (OAuth 2.1) e o CLI nunca vê a sua palavra-passe. Atua com o seu papel, nunca vê dados de outra escola e o que se envia às famílias ou se publica espera a sua aprovação. badgie logout apaga os tokens locais.
Serve para agentes de IA e scripts?
Sim. --json dá uma saída estável para agentes como OpenClaw ou Claude Code, pipelines de CI e tarefas agendadas.
Preciso de saber programar?
Não para o chat: basta escrever badgie e conversar. run e --json são para quem quer automatizar.
Há uma API REST pública em vez do CLI?
Não. O Badgie não oferece uma API REST pública com chaves nem webhooks de saída. O caminho para programadores é o servidor MCP e o Badgie CLI.
Gasta créditos?
O chat com o agente consome créditos do clube, tal como no painel (/creditos mostra o saldo). run e repl executam ferramentas sem passar pelo agente.