# @jelou/cli

[![npm version](https://img.shields.io/npm/v/@jelou/cli?color=00d775&label=npm)](https://www.npmjs.com/package/@jelou/cli)
[![weekly downloads](https://img.shields.io/npm/dw/@jelou/cli?color=00d775)](https://www.npmjs.com/package/@jelou/cli)
[![license](https://img.shields.io/badge/license-Proprietary-blue)](./LICENSE)
[![node](https://img.shields.io/node/v/@jelou/cli)](#)

Build AI agents for WhatsApp on the [Jelou](https://jelou.ai) platform from your
terminal — or just ask your AI editor. Agent skills auto-install into Claude
Code, Cursor, Codex, and Windsurf on `jelou login`.

## Install

**Requirements:** [Node.js](https://nodejs.org/) 18+ and npm. For the prompt
route, an AI editor —
[Claude Code](https://docs.anthropic.com/en/docs/claude-code), Cursor, Codex, or
Windsurf.

### Install with a prompt

Open Claude Code, Cursor, Codex, or Windsurf and paste this. The agent does the
rest:

> Install the Jelou CLI: run **`npm install -g @jelou/cli`**, verify it with
> `jelou --version`, then ask me for my Jelou API key (from
> https://apps.jelou.ai/settings/api-keys) and run `jelou login --token <key>`
> to authenticate. Finally run `jelou agent install` so the Jelou agent skills
> are installed into this editor — then you can build, test, and ship Jelou
> workflows for me from here.

### Install manually

```bash
npm install -g @jelou/cli   # requires Node.js 18+
jelou login                 # paste your API key; skills auto-install
```

Verify with `jelou --version`. Prefer to keep your key out of the chat history?
The manual route reads it from a masked prompt.

## Sign up

Don't have a Jelou account yet?
[Create one free](https://apps.jelou.ai/signup?plan=brain-free&source=cli_readme&lang=en&step=provider)
— takes a minute.

## Quickstart

```bash
jelou login                          # agent skills auto-install into Claude
                                     # Code, Cursor, Codex, and Windsurf
mkdir my-project && cd my-project    # project files live in this folder
```

Open a fresh session in any of those editors from that folder and ask for what
you want — "build a support workflow", "deploy a Stripe webhook", "send a
WhatsApp campaign". The agent picks the right `jelou` command and runs it.

Prefer the terminal? `jelou --help` browses the full command tree.

## What you can do

- **Build workflows** — design, test, and ship project workflows end-to-end
- **Build functions** — serverless functions integrated into the Jelou ecosystem
- **Test before shipping** — record runs, trace step-by-step, search messages,
  and open a local test dashboard for your workflows
- **Debug live conversations** — list, grep, and walk one user's chat timeline;
  reset a user's cached state with a bot to retest cleanly
- **Connect channels** — wire projects to Web, WhatsApp, Facebook, Instagram
- **Manage WhatsApp** — bots, outbound templates, and bulk campaigns
- **Manage databases** — provision and operate Jelou-managed databases
- **Browse the marketplace** — connect 3,000+ integrations including payments
  and KYC
- **Manage secrets** — organization-level environment variables

Run `jelou --help` for the full command tree.

## Test a project branch

```bash
jelou test project start --channel <channel-id> --ref branch:qa --json
jelou test project send <session-id> --message "Hola" --json
```

The MCP tester accepts the same `ref`. See
[project branch testing](docs/testing-project-branches.md) for session
lifecycle, routing limits and error handling.

## Use it from your AI editor

`jelou` ships agent skills that auto-install on `jelou login`. Open a fresh
session in Claude Code, Cursor, Codex, or Windsurf and just ask:

> "Build a customer support workflow"
>
> "Deploy a function that handles Stripe webhooks"
>
> "Send a WhatsApp campaign to my Black Friday list"
>
> "Provision a database for analytics"
>
> "Install the Stripe integration"
>
> "Why did this conversation go wrong yesterday at 3pm?"

The matching `jelou` command runs for you — agents pick the right flags from
context.

Manage skills any time:

```bash
jelou agent install   # interactive wizard
```

## Profiles

Switch between accounts and environments without re-logging in.

```bash
jelou login                                    # interactive — creates a profile
jelou login --profile staging                  # add another profile
jelou auth list                                # show profiles
jelou auth switch staging                      # change active profile
jelou functions deploy --profile production    # one-shot override
```

## Documentation

- [docs.jelou.ai](https://docs.jelou.ai) — full reference, guides, and tutorials
- [jelou.ai](https://jelou.ai) — Jelou platform
- [CHANGELOG.md](./CHANGELOG.md) — release notes and version history

## Repository layout

This repo is a small monorepo: the Deno CLI lives at the root (`mod.ts`,
`src/`), the shared API-client layer is `packages/api` (`@jelou/api`), and
`packages/mcp-server` is a separate Node service — a vendor-hosted MCP server
that exposes Jelou tools to MCP clients. See
[`packages/mcp-server/README.md`](./packages/mcp-server/README.md).

## License

Copyright 2026 Jelou Inc. All rights reserved. See [LICENSE](./LICENSE).

Your use is also subject to the
[Jelou Terms and Conditions](https://jelou.ai/es/terms-and-conditions).