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
-
--require-llm— falla si no hay modelo; no usa plantilla de respaldo. -
--html— genera también vista HTML del material. -
--output-dir <dir>(o--salida) — carpeta de salida. -
--asignatura-id <id>— asignatura cuando el comando no la infiere sola.