> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills for AI editors

> The Jelou CLI installs skills (markdown capability packages) into your AI editors so an agent knows how to operate the platform. Install them, update them, and manage their versions.

The Jelou CLI is **agent-native**: in addition to running from the terminal, it
bundles **skills** — markdown capability packages — that are installed in
your AI editors. Once installed, an agent (Claude Code, Cursor, Codex,
Windsurf, etc.) knows which `jelou` commands exist, what each product
area does, and how to chain them, so you can ask it in natural language
*"deploy this function"* or *"build a support flow"* and it picks the right
command.

## How they work

* On your **first successful `jelou login`**, the CLI detects the installed
  AI editors and installs the skills globally into them. New sessions in those
  editors already know about `jelou`.
* Each skill is written as markdown under an editor's skills directory. The
  CLI writes a canonical copy to `<root>/.agents/skills/<skill>/` and then
  creates symlinks (or copies, on systems that block symlinks) to the
  directory of each detected agent.
* All skills derive their version from the CLI binary's version: when
  you update `jelou`, all skills are reported as updated.

<Note>
  "Skill" here means the **markdown package** that `jelou agent install` writes
  into the AI editors. Don't confuse it with the legacy sense of "skill" as
  a *workflow* within a project.
</Note>

## `jelou agent install`

Install (or reinstall) the skills manually. In an interactive terminal it
asks for target agents, scope, install method, and confirmation. In
CI, JSON mode, agent mode, or with stdout redirected, it never asks.

```bash theme={null}
jelou agent install                                              # interactive
jelou agent install --global --targets codex --yes --no-input    # one agent
jelou agent install --global --all-targets --yes --no-input      # all
jelou agent install --global --only project,whatsapp --targets codex,claude
```

| Flag                       | Description                                                             |
| -------------------------- | ----------------------------------------------------------------------- |
| `--global`                 | Installs to the user home (all projects) instead of the current project |
| `--targets <a,b>`          | List of specific target agents                                          |
| `--all-targets`            | Installs to all detected agents                                         |
| `--only <s1,s2>`           | Installs only the specified skills                                      |
| `--method <symlink\|copy>` | Install method (`symlink` by default: a single source of truth)         |
| `--api`                    | Installs the API-focused SDK variant where available (Functions only)   |
| `--yes`                    | Skips confirmation (for CI/non-interactive)                             |

### Supported AI editors

The CLI detects and supports these targets:

| Universal (`.agents/skills`)                                    | Specific                                                                                       |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Amp, Codex, Gemini CLI, GitHub Copilot, OpenCode, Kimi Code CLI | Claude Code (`.claude/skills`), Cursor (`.cursor/skills`), Windsurf, Cline, Continue, Roo Code |

## `jelou skills`

Inspect and manage the versions of the installed skills.

```bash theme={null}
jelou skills list                          # bundled vs. installed skills
jelou skills check --skill jelou-functions # detect whether a skill is outdated
jelou skills acknowledge --skill jelou-functions   # mark its version as seen
jelou skills ack-update --version 1.53.0   # dismiss the CLI update notice
```

| Subcommand                   | Description                                                                                       |
| ---------------------------- | ------------------------------------------------------------------------------------------------- |
| `list`                       | Lists all skills with their bundled and installed version                                         |
| `check --skill <name>`       | Detects drift and emits version markers (`CLI_OUTDATED`, `CLI_UPDATE_AVAILABLE`, `SKILL_UPDATED`) |
| `acknowledge --skill <name>` | Marks a skill's version as seen; clears the `SKILL_UPDATED` flag                                  |
| `ack-update --version <v>`   | Dismisses the `CLI_UPDATE_AVAILABLE` notice for that version                                      |

## Available skills

The CLI bundles these skills (several include variants and additional reference
files):

| Skill                      | Covers                                                                          |
| -------------------------- | ------------------------------------------------------------------------------- |
| `jelou`                    | Installation, auth, profiles, output modes, and CLI navigation                  |
| `jelou-functions`          | Serverless functions (`cli` and `api` variants)                                 |
| `jelou-databases`          | Managed databases (alias `jelou-datum`)                                         |
| `jelou-project`            | Projects, knowledge files, and channels                                         |
| `jelou-whatsapp`           | WhatsApp bots, templates, and campaigns                                         |
| `jelou-shop`               | Jelou Shop catalog, products, orders, and coupons (ecommerce)                   |
| `jelou-debug-conversation` | Triage of production conversations (logs)                                       |
| `jelou-insights`           | Conversation analytics: FAQs, friction, sentiment, and automation opportunities |
| `jelou-feedback`           | Sending reports from the CLI                                                    |

In addition, the **BrainOps bundles** are more complete installable packages (with
executables, references, and hooks) for building and testing workflows:
`jelou-build-workflows` (building workflows), `jelou-test-workflow`
(QA for a single workflow), and `jelou-audit-workflows` (read-only audits).

## Keeping skills up to date

After updating the CLI, refresh the installed skills so that new
sessions see the changes:

```bash theme={null}
npm install -g @jelou/cli@latest
jelou --version
jelou agent install --global --all-targets --yes --no-input
```

<Tip>
  If an agent doesn't seem to know about `jelou`, run
  `jelou agent install --global` and open a **new session** of the editor — the
  skills load at the start of the session.
</Tip>