Skip to main content
Um projeto é um assistente de IA com seus arquivos de conhecimento, seus canais e seus workflows. O subcomando jelou project administra o ciclo de vida do projeto; jelou channels conecta o projeto a canais de mensageria; e os comandos de sincronização (link, pull, status, push, incoming) levam os workflows do projeto para arquivos locais e de volta.
“Brain” é o nome legado de “project”. --brain é aceito como alias de --project em jelou link e jelou channels, e vários campos a nível de API conservam o nome brain — mas o nome canônico é project.

​
jelou project

​
Conhecimento

Suba documentos para que o assistente os use como base de conhecimento. Formatos suportados: PDF, TXT, CSV (máx. 2 MB por arquivo).

​
Publicar e restaurar

project delete é em cascata e irreversível: exclui o projeto, seu workspace, sua skill padrão e seu canal sandbox. publish e restore afetam a produção imediatamente, e excluir um arquivo de conhecimento dispara um re-treinamento (as respostas podem mudar). Execute project show e confirme antes de operações destrutivas.

​
jelou channels

Conecta um projeto a canais de mensageria. Pela CLI, channels create só suporta --type web (widget web). Os canais de WhatsApp, Facebook e Instagram exigem OAuth: o WhatsApp se conecta com jelou channels activate (login da Meta, sem colar credenciais), enquanto Facebook e Instagram só podem ser criados a partir do dashboard.
--type é exato: Facebook são só as DMs do Messenger, Facebook_Feed é a caixa de comentários da página (antes invisível para a CLI); mesmo padrão para Instagram/Instagram_Feed. Conectar uma página do Facebook é só metade do trabalho — cada skill precisa do seu próprio canal do Facebook, adicionado no Studio, ou o motor não encontra para qual workflow rotear esse tráfego e nada responde.
channels connect sobrescreve sem avisar: se o canal já tinha uma conexão, reapontá-lo roteia usuários reais para o novo destino na próxima mensagem recebida. Verifique ambos os destinos antes de conectar.

​
Sincronizar workflows (local ↔ servidor)

Para editar os workflows de um projeto como arquivos locais, primeiro vincule o diretório ao projeto com jelou link, depois baixe (pull), revise (status), edite e suba (push).
Escreve jelou.yml (vínculo compartilhado pela equipe — versione-o no git) e .jelou/state.json (estado local — adicione-o ao .gitignore, a CLI faz isso automaticamente).
jelou link, pull e push escrevem arquivos locais. Requerem um worktree git limpo ou um diretório vazio. Se o diretório estiver sujo ou não versionado, a CLI para; use --allow-dirty apenas após confirmar.

​
pull, status, push

Precisa do panorama completo, não só do status de sync? jelou context --agent entrega numa única chamada a mesma informação de drift que o status, mais identidade, allowlist de modelos de IA, nomes de secrets, inventário de bancos de dados e o catálogo de tipos de nó — substituindo a sequência status + secret list + models list + databases list + workflow node-spec --list para agentes que querem todo o contexto inicial de uma vez.

​
jelou incoming — resolver edições concorrentes

Se um pull detectar que o servidor mudou um workflow que você também editou localmente, ele preserva a versão do servidor em .jelou/incoming/ e sai com código 7. Resolva cada artefato antes de fazer pull novamente:
accept-local faz uma verificação CAS contra o hash do servidor registrado: se o servidor divergiu desde que o artefato foi capturado, ele recusa com NEW_REMOTE_DRIFT. Execute mark-resolved e depois pull para ver a nova divergência.