diff --git a/cli.mdx b/cli.mdx
index cafbc72..57fb180 100644
--- a/cli.mdx
+++ b/cli.mdx
@@ -21,27 +21,32 @@ arara listen --forward-to http://localhost:3000/api/webhooks
## Instalação
+**One-liner** — detecta OS + arquitetura, baixa o binário do GitHub Releases, valida checksum SHA-256 e instala em `/usr/local/bin` (ou `~/.local/bin` se não tiver sudo):
+
+```bash
+curl -fsSL https://get.ararahq.com/install-cli | sh
+```
+
+Alternativas:
+
-
- ```bash
- brew install ararahq/tap/arara
+
+ ```powershell
+ iwr -useb https://get.ararahq.com/install-cli.ps1 | iex
```
-
+
```bash
- curl -fsSL https://get.ararahq.com | sh
+ brew install ararahq/tap/arara
```
```bash
- go install github.com/ararahq/arara-cli/cmd/arara@latest
+ go install github.com/ararahq/cli/cmd/arara@latest
```
-
- ```bash
- npm install -g ararahq-cli
- ```
- *baixa o binário Go correspondente no postinstall*
+
+ [github.com/ararahq/cli/releases](https://github.com/ararahq/cli/releases) — tar.gz/zip por OS+arch + checksums.txt.
@@ -49,7 +54,7 @@ Confere a versão:
```bash
arara --version
-# arara 0.2.0 (2026-05-12)
+# arara version 0.1.0
```
## Login
@@ -68,6 +73,40 @@ arara profile switch cliente-x
arara profile list
```
+## Modo LIVE vs TEST
+
+Por default, depois do `arara login` o profile fica em **TEST** — `send` simula entrega, `campaigns` simula custo, nada chega no cliente real.
+
+Pra mandar mensagens reais, promove pra **LIVE**:
+
+```bash
+arara mode live
+```
+
+A CLI cria uma API key LIVE server-side e guarda no keyring do SO. **O valor da chave nunca aparece na tela nem fica no shell history.**
+
+Pra voltar:
+
+```bash
+arara mode test
+arara login # restaura sessão OAuth
+```
+
+Confere o modo a qualquer momento:
+
+```bash
+arara mode
+# Profile default -- LIVE
+```
+
+
+ Em LIVE, **todo `send` cobra do saldo da wallet** e entrega de verdade. Em TEST, custo zero, entrega simulada.
+
+
+
+ Pra criar chave LIVE a conta precisa estar `ACTIVE` (onboarding completo). Se vier `ACCOUNT_NOT_ACTIVATED`, complete o wizard em [ararahq.com/dashboard](https://ararahq.com/dashboard).
+
+
## Comandos principais
### `arara send`
@@ -179,6 +218,7 @@ UUID local, batches de até 50 events em 5min, zero PII.
| Comando | Função |
|---|---|
| `arara whoami` | Quem está logado, em qual org, qual modo da chave. |
+| `arara mode [live\|test]` | Mostra ou troca o modo do profile sem expor chave. Ver [Modo LIVE vs TEST](#modo-live-vs-test). |
| `arara doctor` | Diagnóstico: token válido, rede ok, latência, versão atualizada. |
| `arara status` | Status público da Arara (igual `status.ararahq.com`). |
| `arara campaigns list/get` | Lista e detalhe de campanhas. |