Skip to main content
Un proyecto es un asistente de IA con sus archivos de conocimiento, sus canales y sus workflows. El subcomando jelou project administra el ciclo de vida del proyecto; jelou channels conecta el proyecto a canales de mensajería; y los comandos de sincronización (link, pull, status, push, incoming) llevan los workflows del proyecto a archivos locales y de vuelta.
“Brain” es el nombre legacy de “project”. --brain se acepta como alias de --project en jelou link y jelou channels, y varios campos a nivel de API conservan el nombre brain — pero el nombre canónico es project.

jelou project

Conocimiento

Sube documentos para que el asistente los use como base de conocimiento. Formatos soportados: PDF, TXT, CSV (máx. 2 MB por archivo).

Publicar y restaurar

project delete es en cascada e irreversible: elimina el proyecto, su workspace, su skill por defecto y su canal sandbox. publish y restore afectan producción de inmediato, y borrar un archivo de conocimiento dispara un re-entrenamiento (las respuestas pueden cambiar). Ejecuta project show y confirma antes de operaciones destructivas.

jelou channels

Conecta un proyecto a canales de mensajería. Por CLI, channels create solo soporta --type web (widget web). Los canales de WhatsApp, Facebook e Instagram requieren OAuth: WhatsApp se conecta con jelou channels activate (inicio de sesión de Meta, sin pegar credenciales), mientras que Facebook e Instagram solo se pueden crear desde el dashboard.
--type es exacto: Facebook son solo los DMs de Messenger, Facebook_Feed es la bandeja de comentarios de la página (antes invisible para el CLI); mismo patrón para Instagram/Instagram_Feed. Conectar una página de Facebook es solo la mitad del trabajo — cada skill necesita su propio canal de Facebook, agregado desde Studio, o el motor no encuentra a qué workflow enrutar ese tráfico y nada responde.
channels connect sobrescribe sin avisar: si el canal ya tenía una conexión, re-apuntarlo enruta usuarios reales al nuevo destino en el siguiente mensaje entrante. Verifica ambos destinos antes de conectar.

Sincronizar workflows (local ↔ servidor)

Para editar los workflows de un proyecto como archivos locales, primero vincula el directorio al proyecto con jelou link, luego baja (pull), revisa (status), edita y sube (push).
Escribe jelou.yml (vínculo compartido por el equipo — versiónalo en git) y .jelou/state.json (estado local — añádelo a .gitignore, el CLI lo hace automáticamente).
jelou link, pull y push escriben archivos locales. Requieren un worktree git limpio o un directorio vacío. Si el directorio está sucio o no versionado, el CLI se detiene; usa --allow-dirty solo tras confirmar.

pull, status, push

¿Necesitas el panorama completo, no solo el estado de sync? jelou context --agent entrega en una sola llamada la misma información de drift que status más identidad, allowlist de modelos de IA, nombres de secretos, inventario de bases de datos y el catálogo de tipos de nodo — reemplaza la secuencia status + secret list + models list + databases list + workflow node-spec --list para agentes que quieren todo el contexto de arranque de una sola vez.

jelou incoming — resolver ediciones concurrentes

Si un pull detecta que el servidor cambió un workflow que también editaste local, preserva la versión del servidor bajo .jelou/incoming/ y sale con código 7. Resuelve cada artefacto antes de volver a hacer pull:
accept-local hace una verificación CAS contra el hash del servidor registrado: si el servidor divergió desde que se capturó el artefacto, se niega con NEW_REMOTE_DRIFT. Ejecuta mark-resolved y luego pull para ver la nueva divergencia.