Badgie CLI: run your club from the terminal

• npm package: @badgie/cli (version 1.5.5 in October 2026). Command: badgie.
• Runs on any system with Node.js 20 or later (macOS, Linux and Windows).
• It is a client of the Badgie MCP server: same tools, same sign-in with your account and the same Delegation.
• The CLI's own messages are in Spanish.

• badgie or badgie chat: talk to your club's agent.
• badgie login: sign in with your Badgie account (opens the browser).
• badgie logout: sign out and delete local tokens.
• badgie whoami [--json]: show your role and school.
• badgie tools [filter] [--json]: list what you can do (your role's tools).
• badgie run <tool> [key=value…] [--args '<json>'] [--json]: run a tool. Reads return data; writes follow your club's Delegation.
• badgie update [--check] [--json] [--channel <dist-tag>]: update the CLI to the latest published version.
• badgie repl: the classic tool REPL, without the agent.

1. Install the CLI: npm i -g @badgie/cli (or use npx @badgie/cli without installing).
2. Sign in: badgie login. The browser opens, you log in with your Badgie account and approve access.
3. Check who you are: badgie whoami.
4. See what you can do: badgie tools. The catalogue depends on your role.
5. Run a tool, for example badgie run get_top_debtors limit=10. For nested arguments use dot notation (payload.student_id=…) or pass the full JSON with --args.
6. Or just type badgie and chat with your club's agent.

Without a session, commands that need your account say so: «No has iniciado sesión. Ejecuta badgie login.» (you are not signed in; run badgie login).

Type / and press Tab or → to complete. Each role sees its own commands.

• Club: /hoy (today: classes, roll calls not taken, alerts), /semana (the week in figures), /pendientes (proposals waiting for your OK), /deudores (who owes money), /alumno <name>, /insignias, /asistencia [group], /leads, /mensaje <to whom> <what> (drafts and proposes a send), /cantera (football teams, fixtures and results), /swing [student], /informe <topic>, /recuerda <fact> and /memoria.
• Session: /model [level] (fast, balanced or maximum), /bien and /mal [what failed] to rate the last answer, /nuevo, /creditos, /whoami, /tools [filter], /run <tool> k=v… (without the agent), /limpiar, /ayuda, /logout and /salir.

It is the same agent you have in the dashboard and the app, with the same club credits.

• Add --json to whoami, tools, run or update to get JSON output designed for agents and scripts.
• To keep the CLI up to date unattended: badgie update --check --json | jq -e '.updateAvailable' >/dev/null && badgie update --json.
• Environment variables: BADGIE_NO_UPDATE_NOTIFIER=1 (silences the new-version notice), BADGIE_DISABLE_UPDATES=1 (blocks updates), BADGIE_UPDATE_CHANNEL (channel, latest by default) and BADGIE_REGISTRY (alternative npm registry).
• badgie update uses the package manager you installed it with.

You do not choose the role: it comes from your Badgie account.

• School account: badgie run get_top_debtors, badgie run list_action_catalog (actions you can propose) and badgie run list_my_proposals (status of your proposals).
• Coach: badgie run my_classes_today, badgie run my_students, award_badge to award badges and record_attendance to take the roll.
• Student or family: badgie run my_badges, badgie run my_schedule, badgie run my_payments and badgie run my_golf_stats.