Saltar al contenido principal

Instalación

npm install -g @jelou/cli
Verifica:
jelou --version

Autenticación

jelou login

Autenticarse con un token de acceso personal (PAT) o API key de Jelou.
jelou login
# ? Paste your access token: ****
# ? Profile name: default
# ✓ Saved as profile "default"
FlagDescripción
--token <token>Token para uso no interactivo (CI)
--profile <name>Nombre del perfil a guardar
# CI/CD
jelou login --token jfn_pat_abc123 --profile ci

jelou logout

Elimina credenciales almacenadas.
jelou logout              # elimina el perfil activo
jelou logout --all        # elimina todos los perfiles
jelou logout --profile ci # elimina un perfil específico

jelou whoami

Muestra la identidad actual.
jelou whoami
# ▸ Type     Personal Access Token
# ▸ Name     [email protected]
# ▸ Scopes   functions:read, functions:write
# ▸ API      https://app.jelou.ai
# ▸ Profile  default (from credentials file)

jelou auth list

Lista todos los perfiles guardados.
jelou auth list
# ▸ Profile    Identity         Type    Active
# ▸ default    [email protected]    PAT     ✓
# ▸ staging    [email protected]      PAT

jelou auth switch [name]

Cambia el perfil activo.
jelou auth switch staging

jelou auth remove <name>

Elimina un perfil.
jelou auth remove staging -y

Proyectos

jelou init

Inicializa un proyecto de Jelou Functions.
jelou init
# ? What is your function name? mi-funcion
# ? Add a description? Consulta de clientes
# ? Link to existing function or create new? Create new
# ✓ Created mi-funcion
FlagDescripción
--slug <slug>Nombre de la función
--description <desc>Descripción
--mode <create|link>Crear nueva o enlazar existente
--forceSobrescribir jelou.json existente
Genera: index.ts, jelou.json, deno.json, .env, .gitignore.

jelou dev

Inicia el servidor de desarrollo local con hot reload.
jelou dev
# ▸ Function     mi-funcion
# ▸ Entrypoint   index.ts
# ▸ Port         3000
# ▸ Mode         define
# ▸ Routes       http://localhost:3000
# ▸ Health       http://localhost:3000/__health
# ▸ MCP          http://localhost:3000/mcp
FlagDescripción
--port <number>Puerto (default: 3000)
--env <path>Ruta al archivo .env
--no-watchDesactivar hot reload
--local-sdk <path>Usar un SDK local para desarrollo
El servidor detecta automáticamente si tu función usa define() o app() y muestra las rutas correspondientes.

Despliegue

jelou deploy

Despliega a producción.
jelou 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
FlagDescripción
--no-confirmOmitir confirmación (para CI)
--followStreaming de logs después del deploy
El primer deploy genera automáticamente un runtime token.

jelou rollback [slug] [id]

Revierte a un despliegue anterior.
# Interactivo — muestra menú de despliegues recientes
jelou rollback

# Directo
jelou rollback mi-funcion dep_abc12345

jelou deployments list [slug]

Lista el historial de despliegues.
jelou deployments list mi-funcion
# ▸ ID             Status   Source   Files  Deployed By    Age
# ▸ dep_abc123..   active   cli      3      [email protected]  2h ago
# ▸ dep_def456..   active   cli      3      [email protected]    1d ago

jelou deployments info <slug> <id>

Muestra detalles de un despliegue específico.
jelou deployments info mi-funcion dep_abc123

jelou deployments download <slug> <id>

Descarga el artifact de un despliegue.
jelou deployments download mi-funcion dep_abc123 -o artifact.tar.gz

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
# ▸ webhook-pagos       active   https://webhook-pagos.fn.jelou.ai      4/5/2026

jelou functions info <slug>

Muestra detalles de una función.
jelou functions info consultar-cliente
# ▸ Name          consultar-cliente
# ▸ Slug          consultar-cliente
# ▸ Status        active
# ▸ URL           https://consultar-cliente.fn.jelou.ai
# ▸ Deployment    dep_abc12345

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.
jelou functions delete mi-funcion
# ? Delete function "mi-funcion"? This cannot be undone. (y/N)
Usa -y para omitir confirmación en CI.

Secrets

jelou secrets list <slug>

jelou secrets list mi-funcion
# ▸ Key              Updated
# ▸ CRM_API_KEY      2 hours ago
# ▸ JELOU_API_KEY    3 days ago

jelou secrets set <slug>

# Inline
jelou secrets set mi-funcion CRM_API_KEY=sk_test_123 DB_URL=postgres://...

# Desde archivo
jelou secrets set mi-funcion --from-env .env.production

# Interactivo
jelou secrets set mi-funcion

jelou secrets delete <slug> <key>

jelou secrets delete mi-funcion CRM_API_KEY

Tokens

jelou tokens list [slug]

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

jelou tokens create [slug]

jelou tokens create mi-funcion --name ci-deploy
# ✓ Created token "ci-deploy"
# ▸ Token    jfn_rt_def456...
# ⚠ Save this token now — it will not be shown again.

jelou tokens revoke <slug> <token-id>

jelou tokens revoke mi-funcion token-uuid-123 -y
# ✓ Token revoked

Logs

jelou logs [slug]

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

Cron

jelou cron list [slug]

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

jelou cron logs [slug]

jelou cron logs mi-funcion
jelou cron logs mi-funcion --state ERROR
jelou cron logs mi-funcion --cursor <cursor>

Skill

jelou skill install

Instala el skill de Jelou Functions en herramientas de IA.
jelou skill install           # local (proyecto actual)
jelou skill install --global  # global (todos los proyectos)
jelou skill install --api     # variante enfocada en API

Flags globales

FlagDescripción
--jsonOutput JSON a stdout
--no-inputDesactivar prompts interactivos
--profile <name>Usar un perfil específico

Variables de entorno

VariableDescripción
JELOU_TOKENToken de autenticación (sin necesidad de jelou login)
JELOU_NO_INPUT1 para modo no interactivo
CItrue para modo no interactivo (detectado automáticamente)
JELOU_PROFILEPerfil 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 deploy --no-confirm --json | jq -r '.data.url'