> ## 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.

# Jelou CLI

> A CLI da Jelou (jelou): um único binário para construir e operar Functions, projetos, canais, bancos de dados, WhatsApp, marketplace e muito mais — pelo terminal ou pelo seu editor de IA.

`jelou` é o ponto de entrada para toda a plataforma da Jelou pelo terminal.
Um único binário reúne várias superfícies de produto: **Functions** (funções
serverless), **projetos** (assistentes de IA + canais), **bancos de dados**
(Datum), **WhatsApp** (bots, modelos e campanhas), **marketplace** e
**secrets** de organização.

A CLI é **agente-nativa**: foi projetada para que um agente de IA (Claude
Code, Cursor, Codex, Windsurf…) a conduza, e para que um humano a use pelo
terminal. Ao executar `jelou login`, a CLI **instala automaticamente skills**
nos editores de IA detectados, de modo que qualquer sessão nova já saiba
operar o `jelou`. Veja [Skills](/pt/guias/cli/skills).

## Instalação

```bash theme={null}
npm install -g @jelou/cli
```

Você também pode instalá-la com o Deno:

```bash theme={null}
deno install -A -f -n jelou --global jsr:@jelou/cli
```

O Deno grava o binário em `~/.deno/bin/`. Se esse diretório não estiver no seu
`PATH`:

```bash theme={null}
echo 'export PATH="$HOME/.deno/bin:$PATH"' >> ~/.bashrc
```

Verifique a instalação:

```bash theme={null}
jelou --version
```

<Tip>
  Ainda não tem uma conta na Jelou? [Crie uma gratuitamente](https://apps.jelou.ai/signup?plan=brain-free\&source=cli_docs\&lang=pt).
</Tip>

## Quickstart

```bash theme={null}
jelou login          # as skills são auto-instaladas nos seus editores de IA
mkdir meu-projeto && cd meu-projeto
```

Abra uma sessão nova no Claude Code, Cursor, Codex ou Windsurf a partir dessa pasta
e peça o que precisar em linguagem natural — *"construa um fluxo de suporte"*,
*"faça o deploy de um webhook do Stripe"*, *"envie uma campanha de WhatsApp"*. O agente
escolhe o comando `jelou` correto e o executa.

Prefere o terminal? `jelou --help` percorre toda a árvore de comandos.

## Mapa de comandos

| Você quer…                                                                           | Use                                                                             | Página                                                 |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Autenticar-se, gerenciar perfis/empresas e sair                                      | `jelou login`, `jelou whoami`, `jelou logout`, `jelou auth …`, `jelou profiles` | [Autenticação](/pt/guias/cli/autenticacion)            |
| Instalar/atualizar skills nos editores de IA                                         | `jelou agent install`, `jelou skills …`                                         | [Skills](/pt/guias/cli/skills)                         |
| Criar projetos, subir conhecimento, conectar canais                                  | `jelou project …`, `jelou channels …`                                           | [Projetos e canais](/pt/guias/cli/project)             |
| Ver todo o workspace em uma única chamada (identidade, drift, modelos, secrets, DBs) | `jelou context`                                                                 | [Projetos e canais](/pt/guias/cli/project)             |
| Sincronizar workflows local ↔ servidor e resolver conflitos                          | `jelou link`, `jelou pull`, `jelou status`, `jelou push`, `jelou incoming`      | [Projetos e canais](/pt/guias/cli/project)             |
| Gerenciar tools reutilizáveis entre os projetos do app                               | `jelou tool …`, `jelou test tool …`                                             | [Projetos e canais](/pt/guias/cli/project)             |
| Provisionar e operar bancos de dados                                                 | `jelou databases …` (alias `jelou datum …`)                                     | [Bancos de dados](/pt/guias/cli/databases)             |
| Construir, testar e depurar workflows                                                | `jelou workflow …`, `jelou test …`, `jelou logs …`, `jelou users …`             | [Workflows e testes](/pt/guias/cli/workflows)          |
| Gerenciar modelos e campanhas de WhatsApp                                            | `jelou template …`, `jelou campaign …`                                          | [WhatsApp](/pt/guias/cli/whatsapp)                     |
| Rotear atendimento humano (operadores e times)                                       | `jelou connect operators …`, `jelou connect teams …`                            | [Connect](/pt/guias/cli/connect)                       |
| Descobrir e validar modelos de IA                                                    | `jelou models …`                                                                | [Modelos de IA](/pt/guias/cli/models)                  |
| Gerenciar o serviço de voz: chamadas, agentes, contatos, campanhas, faturamento      | `jelou voice …`                                                                 | [Voz](/pt/guias/cli/voice)                             |
| Administrar a loja: catálogo, pedidos, cupons                                        | `jelou shop …`                                                                  | [Shop](/pt/guias/cli/shop)                             |
| Instalar integrações do marketplace                                                  | `jelou marketplace …`                                                           | [Marketplace e integrações](/pt/guias/cli/marketplace) |
| Gerenciar secrets de organização ou de um projeto                                    | `jelou secret …`                                                                | [Secrets](/pt/guias/cli/secret)                        |
| Fazer o deploy de funções serverless                                                 | `jelou functions …`                                                             | [CLI de Functions](/pt/guias/funcoes/cli)              |
| Consultar a analítica da empresa: catálogo, uma métrica ou um painel inteiro         | `jelou metrics list`, `jelou metrics get`, `jelou metrics dashboard`            | [Métricas](/pt/guias/cli/metrics)                      |
| Atualizar a CLI, diagnosticar problemas, ver notas de versão e enviar feedback       | `jelou update`, `jelou doctor`, `jelou changelog`, `jelou feedback`             | [Referência](/pt/guias/cli/referencia)                 |
| Flags globais, modos de saída e exit codes                                           | `--agent`, `--json`, `--describe`                                               | [Referência](/pt/guias/cli/referencia)                 |

<Note>
  A [CLI de Functions](/pt/guias/funcoes/cli) documenta em detalhe o subcomando
  `jelou functions` (desenvolvimento local, deploy, secrets e cron de funções).
</Note>

## Modos de saída

Todo comando suporta saída pensada para agentes e para CI:

* `--json` — saída estruturada `{ ok, data }` / `{ ok, error }` no stdout.
* `--agent` — modo agente: implica `--json`, `--no-input`, `--compact` e
  `NO_COLOR`.
* `--describe` — emite o esquema do comando como JSON, sem executá-lo.

Quando o stdout não é um terminal (por exemplo `jelou whoami | jq`), a CLI passa
para JSON automaticamente. Detalhes em [Referência](/pt/guias/cli/referencia).

```bash theme={null}
jelou whoami --json
jelou project list --agent
jelou databases create --describe
```