CLI - Jelou AI Docs

The Functions CLI is part of the unified Jelou CLI (@jelou/cli). Function commands live under the jelou functions … namespace (for example jelou functions deploy), while authentication and profiles are shared with the rest of the platform.

Just getting started with the CLI? First check out the Jelou CLI introduction, the authentication and the skills for AI editors pages. This page documents the jelou functions group in detail.

Installation

npm install -g @jelou/cli

Verify:

jelou --version

Authentication

Authentication is global to the CLI (not specific to functions). Quick summary; details in Authentication and profiles.

jelou login                 # interactive
jelou login --token $JELOU_TOKEN  # non-interactive (CI)
jelou whoami                # current identity
jelou logout                # forget the active profile

In CI, pass the token via an environment variable:

export JELOU_TOKEN=${{ secrets.JELOU_TOKEN }}

Projects

`jelou functions init`

Initializes a Jelou Functions project.

jelou functions init
# ? What is your function name? my-function
# ? Add a description? Customer lookup
# ✓ Created my-function

Flag	Description
`--slug <slug>`	Function name
`--description <desc>`	Description
`--mode <create\|link>`	Create a new function or link to an existing one
`--force`	Overwrite an existing `jelou.json`

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

# CI: create a new function
jelou functions init --slug my-function --mode create --no-input

# CI: link to an existing function
jelou functions init --slug existing-function --mode link --no-input

`jelou functions dev`

Starts the local development server with hot reload.

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

Flag	Description
`--port <number>`	Port (default: 3000)
`--env <path>`	Path to the `.env` file
`--no-watch`	Disable hot reload
`--local-sdk <path>`	Path to a local SDK directory

The server automatically detects whether your function uses define() or app() and displays the corresponding routes.

To exercise deferred runs locally, start with JELOU_FN_DEFER_DEV=1.

`jelou functions check`

Validates the project before deploying. Needs no authentication and no network.

jelou functions check
# ✓ index.ts             valid entrypoint
# ✓ deno.json            plain JSON
# ⚠ package.json         npm @jelou/* entry — use the deno.json import map
# ✓ No blocking issues

It catches what would keep your function from booting in production and warns about questionable configuration. Exits with an error if anything blocking is found.

Run it before deploy in your CI pipelines: it catches the problems without spending a deployment.

Deployment

`jelou functions deploy`

Deploys to production.

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

Flag	Description
`--no-confirm`	Skip confirmation (for CI)
`--follow`, `-f`	Stream logs after the deploy
`--no-wait`	Don’t wait for the deploy to be ready
`--dry-run`	Show what would be uploaded without deploying

The first deploy automatically generates a runtime token.

`jelou functions rollback [slug] [id]`

Reverts to a previous deployment.

jelou functions rollback                          # interactive
jelou functions rollback my-function dep_abc12345  # direct

`jelou functions deployments list [slug]`

Lists the deployment history.

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

jelou functions deployments info my-function dep_abc123
jelou functions deployments download my-function dep_abc123 -o artifact.tar.gz

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

Shows a deployment’s build log — it answers “why did the deploy I just ran fail?”. With no arguments it uses the newest deployment of the current project.

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

Flag	Description
`--all`	Show every line, not just errors and warnings

This is the build log. For the function’s runtime logs use jelou functions logs.

Functions

`jelou functions list`

Lists all functions.

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

`jelou functions info <slug>`

Shows details for a function.

jelou functions info consultar-cliente

`jelou functions create`

Creates a remote function (no local code).

jelou functions create --slug my-api --name "My API"

`jelou functions delete <slug>`

Deletes a function. Requires confirmation (-y to skip it in CI).

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

Secrets

Function-level secrets. For organization-wide secrets, use jelou secret — see Organization secrets.

`jelou functions secrets list <slug>`

jelou functions secrets list my-function
# ▸ Key              Updated
# ▸ CRM_API_KEY      2 hours ago

`jelou functions secrets set <slug>`

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

# A single secret, reading the value from a file
jelou functions secrets set my-function PRIVATE_KEY --from-file key.pem

New values take effect on the next deployment. Run jelou functions deploy to apply them.

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

jelou functions secrets delete my-function CRM_API_KEY

Tokens

Runtime tokens: the bearers (X-Jelou-Token / Authorization: Bearer) that external clients use to invoke a function’s routes. The deploy auto-generates one the first time.

`jelou functions tokens list [slug]`

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

`jelou functions tokens create [slug]`

Mints a new runtime token for a function. The full token is shown once on stdout — save it right away, since tokens list only shows a censored prefix from then on.

jelou functions tokens create my-function --name ci-deploy
# ✓ Token created
# ▸ Token   jfn_rt_abc123def456...   (save it now, it won't be shown again)

jelou functions tokens create   # interactive: prompts for slug and name

Flag	Description
`--name <name>`	Token name

Create separate tokens per environment or integration (for example one for CI and another for an external partner) without touching the token the first deploy generated.

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

Revokes an existing runtime token.

jelou functions tokens revoke my-function token-uuid-123 -y

Logs

`jelou functions logs [slug]`

jelou functions logs my-function              # live streaming (default)
jelou functions logs my-function --history    # historical logs
jelou functions logs my-function -f           # streaming alias

Flag	Description
`--history`	Historical logs instead of streaming
`--follow`, `-f`	Live streaming (default)
`--limit <n>`	Max entries to return
`--since <t>` / `--until <t>`	Time range in ISO 8601
`--order <asc\|desc>`	`asc` (default, oldest first) or `desc` (newest first)
`--cursor <cursor>`	Pagination cursor from a previous request

# Last 100 entries
jelou functions logs my-function --history --limit 100

# Only the last hour
jelou functions logs my-function --history --since 2026-08-03T14:00:00Z

Don’t confuse this with jelou logs (without functions), which accesses a bot’s production conversation logs — see Workflows and testing.

Cron

`jelou functions cron list [slug]`

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

jelou functions cron logs my-function
jelou functions cron logs my-function --state ERROR

Flag	Description
`--state <state>`	Filter by state (`DELIVERED`, `ERROR`, etc.)
`--cursor <cursor>`	Pagination cursor from a previous request

# Next page of cron history
jelou functions cron logs my-function --cursor eyJpZCI6MTIzfQ==

Deferred runs

Inspect the deferred runs your function has booked. Bookings are created from code or via HTTP headers, not from the CLI.

`jelou functions defer list [slug]`

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

By default it shows active bookings (scheduled, firing, cancel_requested).

Flag	Description
`--status <status>`	`active` (default), `scheduled`, `firing`, `fired`, `cancelled`, `failed`
`--key <key>`	Filter by exact tag
`--subject <subject>`	Filter by audience (typically the user ID)
`--limit <n>`	Max rows (1-100)

# The ones that failed
jelou functions defer list my-function --status failed

# The ones for one user
jelou functions defer list my-function --subject user_42

`jelou functions defer get <id>`

Shows the detail of one booking, including the last error if it failed.

jelou functions defer get dinv_01ksqbvyqpe0prt91exc97mh4n

Flag	Description
`--slug <slug>`	Function. Defaults to the current project’s
`--payload`	Include the payload body in the output

Skills for AI editors

The old jelou skill install was unified into jelou agent install, which installs the platform-wide skills (including jelou-functions) into your AI editors.

jelou agent install                 # interactive
jelou agent install --global        # global (all projects)
jelou agent install --only functions

Details in Skills for AI editors.

Global flags

Flag	Description
`--json`	JSON output to stdout
`--agent`	Agent mode (implies `--json --no-input --compact NO_COLOR`)
`--compact`	JSON with no whitespace
`--human`	Force human-readable output even when stdout is piped
`--no-input`	Disable interactive prompts
`--describe`	Emit the command schema as JSON, without executing it
`--profile <name>`	Use a specific profile

Full reference of flags, modes, and exit codes in CLI reference.

Environment variables

Variable	Description
`JELOU_TOKEN`	Authentication token (no need for `jelou login`)
`JELOU_NO_INPUT`	`1` for non-interactive mode
`CI`	`true` for non-interactive mode (detected automatically)
`JELOU_PROFILE`	Default profile

In CI pipelines, use JELOU_TOKEN as an environment variable and --json for parseable output:

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

​Installation

​Authentication

​Projects

​jelou functions init

​jelou functions dev

​jelou functions check

​Deployment

​jelou functions deploy

​jelou functions rollback [slug] [id]

​jelou functions deployments list [slug]

​jelou functions deployments build [slug] [id]

​Functions

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

​Deferred runs

​jelou functions defer list [slug]

​jelou functions defer get <id>

​Skills for AI editors

​Global flags

​Environment variables

Installation

Authentication

Projects

`jelou functions init`

`jelou functions dev`

`jelou functions check`

Deployment

`jelou functions deploy`

`jelou functions rollback [slug] [id]`

`jelou functions deployments list [slug]`

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

Functions

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

Deferred runs

`jelou functions defer list [slug]`

`jelou functions defer get <id>`

Skills for AI editors

Global flags

Environment variables