Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@jelou/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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):

JELOU_TOKEN environment variable
--profile <name> flag (one-shot, does not persist)
JELOU_PROFILE environment variable
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

See LICENSE for details.