CLI - Jelou AI Docs

El CLI de Functions forma parte del CLI unificado de Jelou (@jelou/cli). Los comandos de funciones viven bajo el namespace jelou functions … (por ejemplo jelou functions deploy), mientras que la autenticación y los perfiles se comparten con el resto de la plataforma.

¿Recién empiezas con el CLI? Revisa primero la introducción al CLI de Jelou, la autenticación y las skills para editores de IA. Esta página documenta en detalle el grupo jelou functions.

Instalación

npm install -g @jelou/cli

Verifica:

jelou --version

Autenticación

La autenticación es global del CLI (no específica de funciones). Resumen rápido; detalles en Autenticación y perfiles.

jelou login                 # interactivo
jelou login --token $JELOU_TOKEN  # no interactivo (CI)
jelou whoami                # identidad actual
jelou logout                # olvida el perfil activo

En CI, pasa el token por variable de entorno:

export JELOU_TOKEN=${{ secrets.JELOU_TOKEN }}

Proyectos

`jelou functions init`

Inicializa un proyecto de Jelou Functions.

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

Flag	Descripción
`--slug <slug>`	Nombre de la función
`--description <desc>`	Descripción
`--mode <create\|link>`	Crear una función nueva o enlazar con una existente
`--force`	Sobrescribir `jelou.json` existente

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

# CI: crear una función nueva
jelou functions init --slug mi-funcion --mode create --no-input

# CI: enlazar con una función existente
jelou functions init --slug funcion-existente --mode link --no-input

`jelou functions dev`

Inicia el servidor de desarrollo local con hot reload.

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

Flag	Descripción
`--port <number>`	Puerto (default: 3000)
`--env <path>`	Ruta al archivo `.env`
`--no-watch`	Desactivar hot reload
`--local-sdk <path>`	Ruta al directorio del SDK local

El servidor detecta automáticamente si tu función usa define() o app() y muestra las rutas correspondientes.

Para probar ejecuciones diferidas en local, arranca con JELOU_FN_DEFER_DEV=1.

`jelou functions check`

Valida el proyecto antes de desplegar. No necesita autenticación ni red.

jelou functions check
# ✓ index.ts             entrypoint válido
# ✓ deno.json            JSON plano
# ⚠ package.json         entrada @jelou/* de npm — usa el import map de deno.json
# ✓ Sin problemas bloqueantes

Detecta lo que haría fallar el arranque de tu función en producción y avisa sobre configuraciones dudosas. Termina con error si encuentra algo bloqueante.

Ejecútalo antes de deploy en tus pipelines de CI: detecta los problemas sin gastar un despliegue.

Despliegue

`jelou functions deploy`

Despliega a producción.

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

Flag	Descripción
`--no-confirm`	Omitir confirmación (para CI)
`--follow`, `-f`	Streaming de logs después del deploy
`--no-wait`	No esperar a que el deploy quede listo
`--dry-run`	Mostrar qué se subiría sin desplegar

El primer deploy genera automáticamente un runtime token.

`jelou functions rollback [slug] [id]`

Revierte a un despliegue anterior.

jelou functions rollback                          # interactivo
jelou functions rollback mi-funcion dep_abc12345  # directo

`jelou functions deployments list [slug]`

Lista el historial de despliegues.

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

jelou functions deployments info mi-funcion dep_abc123
jelou functions deployments download mi-funcion dep_abc123 -o artifact.tar.gz

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

Muestra el log de compilación de un despliegue — responde “¿por qué falló el deploy que acabo de hacer?”. Sin argumentos usa el despliegue más reciente del proyecto actual.

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

Flag	Descripción
`--all`	Mostrar todas las líneas, no solo errores y advertencias

Este es el log de compilación. Para los logs de ejecución de la función usa jelou functions logs.

Funciones

`jelou functions list`

Lista todas las funciones.

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

`jelou functions info <slug>`

Muestra detalles de una función.

jelou functions info consultar-cliente

`jelou functions create`

Crea una función remota (sin código local).

jelou functions create --slug mi-api --name "Mi API"

`jelou functions delete <slug>`

Elimina una función. Requiere confirmación (-y para omitirla en CI).

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

Secrets

Secrets a nivel de función. Para secrets de toda la organización, usa jelou secret — ver Secrets de organización.

`jelou functions secrets list <slug>`

jelou functions secrets list mi-funcion
# ▸ Key              Updated
# ▸ CRM_API_KEY      2 hours ago

`jelou functions secrets set <slug>`

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

# Un solo secret leyendo el valor de un archivo
jelou functions secrets set mi-funcion PRIVATE_KEY --from-file key.pem

Los valores nuevos toman efecto en el siguiente despliegue. Ejecuta jelou functions deploy para aplicarlos.

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

jelou functions secrets delete mi-funcion CRM_API_KEY

Tokens

Runtime tokens: los bearers (X-Jelou-Token / Authorization: Bearer) que usan los clientes externos para invocar las rutas de una función. El deploy auto-genera uno la primera vez.

`jelou functions tokens list [slug]`

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

`jelou functions tokens create [slug]`

Genera un nuevo runtime token para una función. El token completo se muestra una sola vez en stdout — guárdalo de inmediato, porque a partir de ahí tokens list solo muestra un prefijo censurado.

jelou functions tokens create mi-funcion --name ci-deploy
# ✓ Token created
# ▸ Token   jfn_rt_abc123def456...   (guárdalo ahora, no vuelve a mostrarse)

jelou functions tokens create   # interactivo: pide slug y nombre

Flag	Descripción
`--name <name>`	Nombre del token

Crea tokens adicionales para separar credenciales por entorno o integración (por ejemplo uno para CI y otro para un partner externo) sin tocar el token que generó el primer deploy.

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

Revoca un runtime token existente.

jelou functions tokens revoke mi-funcion token-uuid-123 -y

Logs

`jelou functions logs [slug]`

jelou functions logs mi-funcion              # streaming en vivo (default)
jelou functions logs mi-funcion --history    # logs históricos
jelou functions logs mi-funcion -f           # alias de streaming

Flag	Descripción
`--history`	Logs históricos en vez de streaming
`--follow`, `-f`	Streaming en vivo (default)
`--limit <n>`	Máximo de entradas a devolver
`--since <t>` / `--until <t>`	Rango temporal en ISO 8601
`--order <asc\|desc>`	`asc` (default, más antiguos primero) o `desc` (más recientes)
`--cursor <cursor>`	Cursor de paginación de una consulta anterior

# Últimas 100 entradas
jelou functions logs mi-funcion --history --limit 100

# Solo lo de la última hora
jelou functions logs mi-funcion --history --since 2026-08-03T14:00:00Z

No confundir con jelou logs (sin functions), que accede a los logs de conversaciones de producción de un bot — ver Workflows y pruebas.

Cron

`jelou functions cron list [slug]`

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

jelou functions cron logs mi-funcion
jelou functions cron logs mi-funcion --state ERROR

Flag	Descripción
`--state <state>`	Filtrar por estado (`DELIVERED`, `ERROR`, etc.)
`--cursor <cursor>`	Cursor de paginación de una consulta anterior

# Página siguiente del historial de cron
jelou functions cron logs mi-funcion --cursor eyJpZCI6MTIzfQ==

Diferidas

Consulta las ejecuciones diferidas que tu función tiene agendadas. Las reservas se crean desde el código o por cabeceras HTTP, no desde el CLI.

`jelou functions defer list [slug]`

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

Por defecto muestra las reservas activas (scheduled, firing, cancel_requested).

Flag	Descripción
`--status <estado>`	`active` (default), `scheduled`, `firing`, `fired`, `cancelled`, `failed`
`--key <key>`	Filtrar por etiqueta exacta
`--subject <subject>`	Filtrar por audiencia (normalmente el ID de usuario)
`--limit <n>`	Máximo de filas (1-100)

# Las que fallaron
jelou functions defer list mi-funcion --status failed

# Las de un usuario
jelou functions defer list mi-funcion --subject user_42

`jelou functions defer get <id>`

Muestra el detalle de una reserva, incluido el último error si falló.

jelou functions defer get dinv_01ksqbvyqpe0prt91exc97mh4n

Flag	Descripción
`--slug <slug>`	Función. Por defecto la del proyecto actual
`--payload`	Incluir el cuerpo del payload en la salida

Skills para editores de IA

El antiguo jelou skill install se unificó en jelou agent install, que instala las skills de toda la plataforma (incluida jelou-functions) en tus editores de IA.

jelou agent install                 # interactivo
jelou agent install --global        # global (todos los proyectos)
jelou agent install --only functions

Detalles en Skills para editores de IA.

Flags globales

Flag	Descripción
`--json`	Output JSON a stdout
`--agent`	Modo agente (implica `--json --no-input --compact NO_COLOR`)
`--compact`	JSON sin espacios
`--human`	Forzar salida legible aunque stdout esté redirigido
`--no-input`	Desactivar prompts interactivos
`--describe`	Emite el esquema del comando como JSON, sin ejecutarlo
`--profile <name>`	Usar un perfil específico

Referencia completa de flags, modos y exit codes en Referencia del CLI.

Variables de entorno

Variable	Descripción
`JELOU_TOKEN`	Token de autenticación (sin necesidad de `jelou login`)
`JELOU_NO_INPUT`	`1` para modo no interactivo
`CI`	`true` para modo no interactivo (detectado automáticamente)
`JELOU_PROFILE`	Perfil por defecto

En pipelines de CI, usa JELOU_TOKEN como variable de entorno y --json para output parseable:

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

​Instalación

​Autenticación

​Proyectos

​jelou functions init

​jelou functions dev

​jelou functions check

​Despliegue

​jelou functions deploy

​jelou functions rollback [slug] [id]

​jelou functions deployments list [slug]

​jelou functions deployments build [slug] [id]

​Funciones

​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]

​Diferidas

​jelou functions defer list [slug]

​jelou functions defer get <id>

​Skills para editores de IA

​Flags globales

​Variables de entorno

Instalación

Autenticación

Proyectos

`jelou functions init`

`jelou functions dev`

`jelou functions check`

Despliegue

`jelou functions deploy`

`jelou functions rollback [slug] [id]`

`jelou functions deployments list [slug]`

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

Funciones

`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]`

Diferidas

`jelou functions defer list [slug]`

`jelou functions defer get <id>`

Skills para editores de IA

Flags globales

Variables de entorno