CLI - Jelou AI Docs

O CLI de Functions faz parte do CLI unificado da Jelou (@jelou/cli). Os comandos de funções vivem sob o namespace jelou functions … (por exemplo jelou functions deploy), enquanto a autenticação e os perfis são compartilhados com o restante da plataforma.

Está começando agora com o CLI? Veja primeiro a introdução ao CLI da Jelou, a autenticação e as skills para editores de IA. Esta página documenta em detalhe o grupo jelou functions.

Instalação

npm install -g @jelou/cli

Verifique:

jelou --version

Autenticação

A autenticação é global do CLI (não específica de funções). Resumo rápido; detalhes em Autenticação e perfis.

jelou login                 # interativo
jelou login --token $JELOU_TOKEN  # não interativo (CI)
jelou whoami                # identidade atual
jelou logout                # esquece o perfil ativo

Em CI, passe o token por variável de ambiente:

export JELOU_TOKEN=${{ secrets.JELOU_TOKEN }}

Projetos

`jelou functions init`

Inicializa um projeto de Jelou Functions.

jelou functions init
# ? What is your function name? minha-funcao
# ? Add a description? Consulta de clientes
# ✓ Created minha-funcao

Flag	Descrição
`--slug <slug>`	Nome da função
`--description <desc>`	Descrição
`--mode <create\|link>`	Criar uma função nova ou vincular a uma existente
`--force`	Sobrescrever `jelou.json` existente

Gera: index.ts, jelou.json, deno.json, .env, .gitignore.

# CI: criar uma função nova
jelou functions init --slug minha-funcao --mode create --no-input

# CI: vincular a uma função existente
jelou functions init --slug funcao-existente --mode link --no-input

`jelou functions dev`

Inicia o servidor de desenvolvimento local com hot reload.

jelou functions dev
# ▸ Function     minha-funcao
# ▸ Port         3000
# ▸ Routes       http://localhost:3000
# ▸ Health       http://localhost:3000/__health
# ▸ MCP          http://localhost:3000/mcp

Flag	Descrição
`--port <number>`	Porta (default: 3000)
`--env <path>`	Caminho para o arquivo `.env`
`--no-watch`	Desativar hot reload
`--local-sdk <path>`	Caminho para o diretório do SDK local

O servidor detecta automaticamente se sua função usa define() ou app() e mostra as rotas correspondentes.

Para exercitar execuções diferidas em local, suba com JELOU_FN_DEFER_DEV=1.

`jelou functions check`

Valida o projeto antes do deploy. Não precisa de autenticação nem de rede.

jelou functions check
# ✓ index.ts             entrypoint válido
# ✓ deno.json            JSON simples
# ⚠ package.json         entrada @jelou/* do npm — use o import map do deno.json
# ✓ Nenhum problema bloqueante

Detecta o que impediria sua função de subir em produção e avisa sobre configurações duvidosas. Termina com erro se encontrar algo bloqueante.

Rode antes do deploy nos seus pipelines de CI: detecta os problemas sem gastar uma implantação.

Deploy

`jelou functions deploy`

Faz o deploy para produção.

jelou functions deploy
# ▸ Files: index.ts (1.2 KB), jelou.json (98 B), deno.json (65 B)
# ? Deploy minha-funcao? (Y/n) y
# ✓ Deployed
# ▸ URL: https://minha-funcao.fn.jelou.ai

Flag	Descrição
`--no-confirm`	Omitir confirmação (para CI)
`--follow`, `-f`	Streaming de logs após o deploy
`--no-wait`	Não esperar o deploy ficar pronto
`--dry-run`	Mostrar o que seria enviado sem fazer o deploy

O primeiro deploy gera automaticamente um runtime token.

`jelou functions rollback [slug] [id]`

Reverte para um deploy anterior.

jelou functions rollback                            # interativo
jelou functions rollback minha-funcao dep_abc12345  # direto

`jelou functions deployments list [slug]`

Lista o histórico de deploys.

jelou functions deployments list minha-funcao
# ▸ ID             Status   Source   Files  Deployed By    Age
# ▸ dep_abc123..   active   cli      3      [email protected]  2h ago

jelou functions deployments info minha-funcao dep_abc123
jelou functions deployments download minha-funcao dep_abc123 -o artifact.tar.gz

`jelou functions deployments build [slug] [id]`

Mostra o log de compilação de um deploy — responde “por que o deploy que acabei de fazer falhou?”. Sem argumentos usa o deploy mais recente do projeto atual.

jelou functions deployments build
# ▸ Status  failed
# ✗ index.ts:14:3 — Property 'telefono' does not exist on type ...

Flag	Descrição
`--all`	Mostrar todas as linhas, não só erros e avisos

Este é o log de compilação. Para os logs de execução da função use jelou functions logs.

Funções

`jelou functions list`

Lista todas as funções.

jelou functions list
# ▸ Slug               Status   URL                                    Updated
# ▸ consultar-cliente   active   https://consultar-cliente.fn.jelou.ai  4/7/2026

`jelou functions info <slug>`

Mostra detalhes de uma função.

jelou functions info consultar-cliente

`jelou functions create`

Cria uma função remota (sem código local).

jelou functions create --slug minha-api --name "Minha API"

`jelou functions delete <slug>`

Exclui uma função. Requer confirmação (-y para omiti-la em CI).

jelou functions delete minha-funcao
# ? Delete function "minha-funcao"? This cannot be undone. (y/N)

Secrets

Secrets a nível de função. Para secrets de toda a organização, use jelou secret — veja Secrets de organização.

`jelou functions secrets list <slug>`

jelou functions secrets list minha-funcao
# ▸ Key              Updated
# ▸ CRM_API_KEY      2 hours ago

`jelou functions secrets set <slug>`

jelou functions secrets set minha-funcao CRM_API_KEY=sk_test_123 DB_URL=postgres://...
jelou functions secrets set minha-funcao --from-env .env.production

# Um único secret lendo o valor de um arquivo
jelou functions secrets set minha-funcao PRIVATE_KEY --from-file key.pem

Os valores novos passam a valer no próximo deploy. Rode jelou functions deploy para aplicá-los.

`jelou functions secrets delete <slug> <key>`

jelou functions secrets delete minha-funcao CRM_API_KEY

Tokens

Runtime tokens: os bearers (X-Jelou-Token / Authorization: Bearer) que os clientes externos usam para invocar as rotas de uma função. O deploy gera um automaticamente na primeira vez.

`jelou functions tokens list [slug]`

jelou functions tokens list minha-funcao
# ▸ Name       Prefix          Last Used              Created
# ▸ default    jfn_rt_abc1..   4/7/2026, 10:30 AM     4/1/2026

`jelou functions tokens create [slug]`

Gera um novo runtime token para uma função. O token completo aparece uma única vez no stdout — guarde-o imediatamente, pois a partir daí tokens list mostra apenas um prefixo censurado.

jelou functions tokens create minha-funcao --name ci-deploy
# ✓ Token created
# ▸ Token   jfn_rt_abc123def456...   (guarde agora, não será exibido de novo)

jelou functions tokens create   # interativo: pede slug e nome

Flag	Descrição
`--name <name>`	Nome do token

Crie tokens separados por ambiente ou integração (por exemplo um para CI e outro para um parceiro externo) sem tocar no token gerado pelo primeiro deploy.

`jelou functions tokens revoke <slug> <token-id>`

Revoga um runtime token existente.

jelou functions tokens revoke minha-funcao token-uuid-123 -y

Logs

`jelou functions logs [slug]`

jelou functions logs minha-funcao              # streaming ao vivo (default)
jelou functions logs minha-funcao --history    # logs históricos
jelou functions logs minha-funcao -f           # alias de streaming

Flag	Descrição
`--history`	Logs históricos em vez de streaming
`--follow`, `-f`	Streaming ao vivo (default)
`--limit <n>`	Máximo de entradas a retornar
`--since <t>` / `--until <t>`	Intervalo temporal em ISO 8601
`--order <asc\|desc>`	`asc` (default, mais antigos primeiro) ou `desc` (mais recentes)
`--cursor <cursor>`	Cursor de paginação de uma consulta anterior

# Últimas 100 entradas
jelou functions logs minha-funcao --history --limit 100

# Só a última hora
jelou functions logs minha-funcao --history --since 2026-08-03T14:00:00Z

Não confundir com jelou logs (sem functions), que acessa os logs de conversas de produção de um bot — veja Workflows e testes.

Cron

`jelou functions cron list [slug]`

jelou functions cron list minha-funcao
# ▸ Tool       Expression   Timezone             Last Triggered
# ▸ default    0 9 * * *    America/Guayaquil    2 hours ago

jelou functions cron logs minha-funcao
jelou functions cron logs minha-funcao --state ERROR

Flag	Descrição
`--state <state>`	Filtrar por estado (`DELIVERED`, `ERROR`, etc.)
`--cursor <cursor>`	Cursor de paginação de uma consulta anterior

# Próxima página do histórico de cron
jelou functions cron logs minha-funcao --cursor eyJpZCI6MTIzfQ==

Execuções diferidas

Inspecione as execuções diferidas que sua função tem agendadas. Os agendamentos são criados pelo código ou por headers HTTP, não pelo CLI.

`jelou functions defer list [slug]`

jelou functions defer list minha-funcao
# ▸ ID                Status      Scheduled At           Key
# ▸ dinv_01ksqbvy..   scheduled   4/8/2026, 9:00:00 AM   carrinho:42:c-9
# ▸ dinv_01ksqcxz..   firing      4/7/2026, 6:00:00 PM   lembrete:user-7

Por padrão mostra os agendamentos ativos (scheduled, firing, cancel_requested).

Flag	Descrição
`--status <estado>`	`active` (default), `scheduled`, `firing`, `fired`, `cancelled`, `failed`
`--key <key>`	Filtrar por etiqueta exata
`--subject <subject>`	Filtrar por audiência (normalmente o ID do usuário)
`--limit <n>`	Máximo de linhas (1-100)

# Os que falharam
jelou functions defer list minha-funcao --status failed

# Os de um usuário
jelou functions defer list minha-funcao --subject user_42

`jelou functions defer get <id>`

Mostra o detalhe de um agendamento, incluindo o último erro se falhou.

jelou functions defer get dinv_01ksqbvyqpe0prt91exc97mh4n

Flag	Descrição
`--slug <slug>`	Função. Por padrão a do projeto atual
`--payload`	Incluir o corpo do payload na saída

Skills para editores de IA

O antigo jelou skill install foi unificado em jelou agent install, que instala as skills de toda a plataforma (incluindo jelou-functions) nos seus editores de IA.

jelou agent install                 # interativo
jelou agent install --global        # global (todos os projetos)
jelou agent install --only functions

Detalhes em Skills para editores de IA.

Flags globais

Flag	Descrição
`--json`	Output JSON para stdout
`--agent`	Modo agente (implica `--json --no-input --compact NO_COLOR`)
`--compact`	JSON sem espaços
`--human`	Forçar saída legível mesmo com stdout redirecionado
`--no-input`	Desativar prompts interativos
`--describe`	Emite o schema do comando como JSON, sem executá-lo
`--profile <name>`	Usar um perfil específico

Referência completa de flags, modos e exit codes em Referência do CLI.

Variáveis de ambiente

Variável	Descrição
`JELOU_TOKEN`	Token de autenticação (sem necessidade de `jelou login`)
`JELOU_NO_INPUT`	`1` para modo não interativo
`CI`	`true` para modo não interativo (detectado automaticamente)
`JELOU_PROFILE`	Perfil padrão

Em pipelines de CI, use JELOU_TOKEN como variável de ambiente e --json para output parseável:

export JELOU_TOKEN=${{ secrets.JELOU_TOKEN }}
jelou functions deploy --no-confirm --json | jq -r '.data.url'

​Instalação

​Autenticação

​Projetos

​jelou functions init

​jelou functions dev

​jelou functions check

​Deploy

​jelou functions deploy

​jelou functions rollback [slug] [id]

​jelou functions deployments list [slug]

​jelou functions deployments build [slug] [id]

​Funções

​jelou functions list

​jelou functions info <slug>

​jelou functions create

​jelou functions delete <slug>

​Secrets

​jelou functions secrets list <slug>

​jelou functions secrets set <slug>

​jelou functions secrets delete <slug> <key>

​Tokens

​jelou functions tokens list [slug]

​jelou functions tokens create [slug]

​jelou functions tokens revoke <slug> <token-id>

​Logs

​jelou functions logs [slug]

​Cron

​jelou functions cron list [slug]

​Execuções diferidas

​jelou functions defer list [slug]

​jelou functions defer get <id>

​Skills para editores de IA

​Flags globais

​Variáveis de ambiente

Instalação

Autenticação

Projetos

`jelou functions init`

`jelou functions dev`

`jelou functions check`

Deploy

`jelou functions deploy`

`jelou functions rollback [slug] [id]`

`jelou functions deployments list [slug]`

`jelou functions deployments build [slug] [id]`

Funções

`jelou functions list`

`jelou functions info <slug>`

`jelou functions create`

`jelou functions delete <slug>`

Secrets

`jelou functions secrets list <slug>`

`jelou functions secrets set <slug>`

`jelou functions secrets delete <slug> <key>`

Tokens

`jelou functions tokens list [slug]`

`jelou functions tokens create [slug]`

`jelou functions tokens revoke <slug> <token-id>`

Logs

`jelou functions logs [slug]`

Cron

`jelou functions cron list [slug]`

Execuções diferidas

`jelou functions defer list [slug]`

`jelou functions defer get <id>`

Skills para editores de IA

Flags globais

Variáveis de ambiente