Referencia

Comandos directos

En la terminal se usan como teacher <comando>. En Pi, con el prefijo /teacher:<comando>. Si no quieres memorizar flags, abre el menú guiado con teacher solo (necesita TTY) y escribe configurador. En CI o entornos sin TTY usa siempre comandos directos.

Nombre de producto y nombre de comando En el catálogo hablamos de «cierre de clase» o «guion»; en la terminal el comando puede llamarse distinto (ticket-salida, preparar-tema). Aquí se documenta el nombre real del CLI. Detalle de cada material en Materiales.

Ayuda y menú

Comando Para qué
teacher Menú guiado (solo con terminal interactiva).
teacher help Listado de ayuda general.
teacher help <comando> Argumentos y ejemplo de un comando concreto.
teacher configurador Selector de paquetes y artefactos sin memorizar el catálogo.

Primeros pasos

Comando Para qué
teacher setup Proveedor, modelo y credenciales (asistente).
teacher setup --proveedor <id> --modelo <id> Setup no interactivo. La clave va en la variable de entorno del proveedor, nunca en un flag.
teacher onboard --asignatura-id <id> --asignatura-nombre <nombre> Crea o selecciona la asignatura local.
teacher ingest --origen <ruta> --asignatura-id <id> Lee PDFs, documentos o carpetas del temario.
teacher status Paquetes, claves, asignatura activa e índice.
teacher config --clave <k> --valor <v> Edita course.config.yml con validación.
teacher config --check Valida el YAML sin modificarlo.
teacher idioma Idioma de salida de materiales nuevos (es / en).

Temario

Comando Para qué
teacher reindex --asignatura-id <id> Vectoriza fragmentos pendientes sin perder el temario.
teacher propose-topics Propone una taxonomía inicial del corpus.
teacher review-topics Revisa, renombra o fusiona temas.
teacher gaps Detecta huecos de material o prerrequisitos.
teacher verify-sources Comprueba fuentes y referencias del corpus.

Materiales de clase

Cada fila es un comando directo. El nombre de producto es el que ves en el catálogo del inicio. Casi todos aceptan --html y --output-dir <dir>.

Material Comando directo Uso típico
Guion de clase preparar-tema teacher preparar-tema "Tema 1" --html --output-dir out
Introducción al tema introductor-tema teacher introductor-tema "Tema 1" --html --output-dir out
Diapositivas diapositivas teacher diapositivas "Tema 1" --html --output-dir out
Glosario generar-vocabulario teacher generar-vocabulario "Tema 1" --html --output-dir out
Bibliografía bibliografia teacher bibliografia "Tema 1"
Caso de debate caso teacher caso "Tema 1" --html --output-dir out
Preguntas de aula preguntas-dinamizar teacher preguntas-dinamizar "Tema 1" --html --output-dir out
Ficha de actividad ficha-actividad teacher ficha-actividad "Tema 1" --html --output-dir out
Errores frecuentes errores-frecuentes teacher errores-frecuentes "Tema 1" --html --output-dir out
Ejemplos y contraejemplos ejemplos-contraejemplos teacher ejemplos-contraejemplos "Tema 1" --html --output-dir out
Analogías banco-analogias teacher banco-analogias "Tema 1" --html --output-dir out
Cierre de clase ticket-salida teacher ticket-salida "Tema 1" --html --output-dir out
Comprobación de comprensión simulador teacher simulador "Tema 1" --html --output-dir out
Laboratorio generar-laboratorio teacher generar-laboratorio "Tema 1" --asignatura-id curso-101 --output-dir out
Pack de prácticas generar-practica teacher generar-practica --asignatura-id curso-101 --temas "Tema 1,Tema 2" --output-dir out
Ejercicios generar teacher generar --asignatura-id curso-101 --tema-filtro "Tema 1" --num-ejercicios 10 --output-dir out
Rúbrica rubrica teacher rubrica --accion crear --asignatura-id curso-101
Valoración de entregas evaluar teacher evaluar practicas/entrega --asignatura-id curso-101
Preguntas Moodle export-moodle teacher export-moodle "Tema 1"
Respuestas de foro foro teacher foro --asignatura-id curso-101 --pregunta "…"
Matriz de competencias matriz-competencias teacher matriz-competencias "Tema 1" --html --output-dir out
Mapa conceptual grafo-conceptual teacher grafo-conceptual "Tema 1" --html --interactivo --gexf
Mapa de la asignatura grafo-curso teacher grafo-curso --html --interactivo --gexf
Calendario export-ics / bind-calendar teacher bind-calendar calendario.ics · teacher export-ics calendario --output-dir out/export

Descripción de cada pieza en Materiales de clase. Flujo paso a paso en Cómo funciona.

Bibliografía y mapas (detalle)

Comando Para qué
teacher bibliografia "<tema>" Fuentes externas relacionadas, verificación APA cuando sea posible.
teacher verificar-refs <archivo> Detecta citas mal formadas o no localizables.
teacher grafo-conceptual "<tema>" --html --interactivo --gexf Mapa del tema (Markdown/Mermaid, HTML, Gephi).
teacher grafo-curso --html --interactivo --gexf Mapa global de la asignatura.

Evaluación

Comando Para qué
teacher foro --asignatura-id <id> --pregunta "<texto>" Respuesta a una duda con citas al temario.
teacher rubrica --accion <crear|listar|eliminar|generar-asistida|exportar-md> --asignatura-id <id> Gestiona rúbricas de la asignatura.
teacher evaluar <carpeta> [--asignatura-id <id>] Informe de valoración de una entrega.

Exportación y calendario

Comando Para qué
teacher export-html <carpeta> --output-path <ruta> Índice HTML navegable de materiales.
teacher visor-rag [--asignatura-id <id>] --output-dir out/visor-rag Visor local del índice (chunks, figuras, vectores).
teacher export-md / export-latex / export-pdf / export-docx Exportaciones por formato (PDF/DOCX pueden requerir Pandoc o LibreOffice).
teacher export-moodle "<tema>" Banco de preguntas para Moodle.
teacher bind-calendar / export-calendar / export-ics Vincular y exportar calendario de sesiones.

Operativa

Comando Para qué
teacher doctor Diagnóstico del entorno (nativos, proveedor, permisos).
teacher cost Tokens, llamadas y coste local si hay precios verificables.
teacher update Comprueba e instala una versión nueva desde GitHub Releases.

Flags habituales