@jelou/cli

Command-line tool for Jelou Functions — serverless TypeScript functions on the edge.

One define() call gives you:

• An HTTP endpoint with Zod validation and CORS
• An MCP tool discoverable by AI agents
• Cron schedules for recurring tasks

Use it to build webhook handlers, chatbot integrations, scheduled cleanups, API proxies, and AI agent tools.

Install

# npm (recommended)
npm install -g @jelou/cli

# npx (no install)
npx @jelou/cli deploy

# Deno
deno install -A -n jelou jsr:@jelou/cli

Verify the installation:

jelou --version

Quick Start

# Authenticate
jelou login

# Create a new function
mkdir my-function && cd my-function
jelou init

# Start local dev server with hot reload
jelou dev
# → http://localhost:3000

# Deploy to production
jelou deploy
# → https://my-function.fn.jelou.ai

Commands

| Group | Command | Description | | ------------ | ------------------- | ----------------------------------- | | Auth | jelou login | Authenticate with your access token | | | jelou logout | Remove stored credentials | | | jelou whoami | Show current identity and scopes | | | jelou auth list | List saved profiles | | | jelou auth switch | Switch active profile | | | jelou auth remove | Remove a saved profile | | Workflow | jelou init | Scaffold a new function project | | | jelou dev | Local dev server with hot reload | | | jelou deploy | Deploy to production | | | jelou rollback | Roll back to a previous deployment | | | jelou logs | Stream or fetch function logs | | Manage | jelou deployments | List, inspect, download deployments | | | jelou functions | List, create, delete functions | | | jelou secrets | Manage environment secrets | | | jelou tokens | Manage access tokens | | | jelou cron | View cron schedules | | Setup | jelou skill | Install Jelou Functions agent skill |

Run jelou <command> --help for flags and usage details.

Profiles

Multiple accounts (or environments) can coexist as named profiles. No more logging in and out when switching between staging and production.

# First login creates a profile (you pick the name)
jelou login
# → Profile name: production

# Add a second account
jelou login --token <staging-token> --profile staging

# List profiles
jelou auth list
#   Profile     Identity       Type  Active
#   production  token "prod"   PAT   ✓
#   staging     jelou:42       API Key

# Switch active profile
jelou auth switch staging

# One-shot override (does not change active profile)
jelou deploy --profile production

# Remove a profile
jelou auth remove staging

Credential Resolution

When resolving which credentials to use, the CLI checks (highest priority first):

1. JELOU_TOKEN environment variable
2. --profile <name> flag (one-shot, does not persist)
3. JELOU_PROFILE environment variable
4. activeProfile in ~/.jelou/credentials.json

Migration from Single-Account

Existing ~/.jelou/credentials.json files are automatically migrated to the multi-profile format on first access. A .bak backup is created. No action required.

CI / Non-Interactive Mode

Every command works headlessly in CI pipelines.

export JELOU_TOKEN=jfn_pat_your_token_here

jelou deploy --no-confirm --json | jq '.data.url'

• --no-input disables all prompts (auto-detected when CI=true or stdin is not a TTY)
• --json outputs { "ok": true, "data": ... } to stdout

See the full CI reference for per-command flags and GitHub Actions examples.

Configuration

| Source | Purpose | | --------------- | --------------------------------------------------- | | jelou.json | Project config (function slug, entrypoint) | | ~/.jelou/ | User credentials (multi-profile) and API URL | | JELOU_TOKEN | Access token (highest priority, overrides profiles) | | JELOU_PROFILE | Select a named profile without --profile flag | | JELOU_API_URL | API base URL override |

See the full configuration reference for details.

Documentation

• CLI Reference — full command docs, flags, CI usage, troubleshooting
• SDK Guide — define() API, context, validation, testing

License

Copyright 2026 Jelou Inc. All rights reserved.

See LICENSE for details.