@badgie/quadrants-cli

CLI oficial de Badgie Quadrants — gestiona cuadrantes de rotacion de tu escuela deportiva desde cualquier terminal.

Novedades 1.1.0

• Analitica: validate-term, teacher-workload, area-heatmap, topic-usage, group-progression, season-compare, find-duplicates, history-for-term.
• Planificacion asistida: suggest-assignment, apply-rotation-pattern, autoplan-term, bulk-assignments, copy-assignments, set-assignment-note, set-term-note, reorder-groups, generate-teacher-briefing.
• Exports: export-term-xlsx y export-season-xlsx con colores, leyenda y hoja de validacion. Usa --out fichero.xlsx para escribir el binario.
• Banner ASCII rediseñado.

Instalar

npm install -g @badgie/quadrants-cli
quadrants help

O sin instalar:

npx @badgie/quadrants-cli help

Empezar

quadrants login                       # email + contrasena de tu cuenta Badgie
quadrants whoami                      # confirma tenants y rol
quadrants list-terms --school adultos
quadrants summarize-term --term adultos-3t-2026

La sesion se guarda en ~/.config/badgie-quadrants/session.json y se refresca automaticamente.

Operaciones disponibles

quadrants tools

Muestra los ~50 verbos disponibles, agrupados:

Lectura

• list-terms, latest-term, get-term, summarize-term, summarize-tenant
• list-topics, list-teachers, list-groups
• get-assignment, list-assignments

CRUD

• add-assignment, move-assignment, delete-assignment, set-assignment-note, bulk-assignments, copy-assignments
• add-topic, update-topic, delete-topic
• add-teacher, update-teacher, delete-teacher
• create-term, clone-term, update-term, archive-term, delete-term, set-term-note
• add-group, update-group, delete-group, reorder-groups
• add-teacher-to-group, remove-teacher-from-group, set-group-teachers

Analitica

• validate-term — auditoria del cuadrante con score 0-100
• teacher-workload — carga por profesor
• area-heatmap — matriz ubicacion x semana
• topic-usage — uso del banco
• group-progression — progresion por grupo
• season-compare — deltas entre cuadrantes
• find-duplicates — duplicados en el banco
• history-for-term — eventos de auditoria

Planificacion asistida

• suggest-assignment — top-N candidatos para una celda con razonamiento
• apply-rotation-pattern — shift-week, swap-groups, mirror
• autoplan-term — relleno completo (estrategias equilibrio-areas, clonar-y-desfasar)
• generate-teacher-briefing — narrativa de la semana de un profesor

Exports

• export-term-xlsx --out fichero.xlsx — XLSX con colores, leyenda y validacion
• export-season-xlsx --terms a,b,c --out temporada.xlsx — libro multi-cuadrante

Admin

• bootstrap-tenant-from-seed, list-tenants (super-admin)

PATs (para MCP HTTP / agentes)

quadrants token create --name "OpenClaw"   # genera bq_... (se muestra UNA vez)
quadrants token list
quadrants token revoke <id>

Usa el PAT con el endpoint MCP remoto:

curl -X POST https://quadrants.badgie.com/api/mcp/v1/mcp \
  -H "Authorization: Bearer bq_..." \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Variables de entorno

| Variable | Default | Para que | |---|---|---| | BADGIE_QUADRANTS_URL | https://wdpaqpzjemzdfruayapi.supabase.co | Override del Supabase URL (staging) | | BADGIE_QUADRANTS_ANON_KEY | (hardcoded prod) | Override de la anon key | | BADGIE_QUADRANTS_API_URL | https://quadrants.badgie.com | Override del backend (para token create/list/revoke) | | BADGIE_QUADRANTS_TOKEN | (unset) | PAT para usar en CI/agentes sin login interactivo |

Licencia

MIT (c) Badgie 2026