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

# NoimosAI CLI

> Converse com o agente do NoimosAI e publique posts sociais ou artigos longos diretamente do terminal.

## Visão geral

O NoimosAI CLI (`@agos-labs/noimosai-cli`) permite operar seu espaço de trabalho do NoimosAI pela linha de comando. Você pode conversar com o agente do NoimosAI para análise de marketing, geração de conteúdo e SEO, publicar posts sociais curtos e artigos longos (WordPress, note) em plataformas conectadas e inspecionar workspaces e integrações sem sair do terminal.

O pacote é publicado no npm como [`@agos-labs/noimosai-cli`](https://www.npmjs.com/package/@agos-labs/noimosai-cli).

## Principais recursos

* **Chat** — conversas interativas ou pontuais com o agente do NoimosAI.
* **Publicação** — envio de posts sociais e artigos longos para contas conectadas.
* **Inspeção de workspaces e integrações** — consulta de workspaces e contas conectadas pela CLI.
* **Automação** — comandos importantes aceitam flags e `--output json` para resultados legíveis por máquina.

## Comandos mais usados

Esses comandos ajudam a entender rapidamente o que a CLI faz.

```bash theme={null}
noimosai login                              # Fazer login (OAuth no navegador ou chave de API)
noimosai chat                               # Iniciar um chat interativo
noimosai chat -p "Draft a launch post"      # Enviar um prompt único
noimosai chat -p "..." -o json              # Prompt único com saída JSON
noimosai post posts.json --dry-run          # Pré-visualizar uma publicação
noimosai post posts.json --now              # Publicar imediatamente
noimosai workspace list                     # Listar workspaces disponíveis
noimosai integration list                   # Listar contas conectadas
```

## Plataformas de publicação compatíveis

Tanto posts curtos quanto artigos longos podem ser publicados a partir de um único `posts.json`.

| Tipo       | Plataforma                                                                               |
| ---------- | ---------------------------------------------------------------------------------------- |
| **SNS**    | X (Twitter), Threads, Facebook, Instagram, YouTube, LinkedIn, TikTok, Bluesky, Pinterest |
| **Artigo** | WordPress, note                                                                          |

## Requisitos

* Node.js `>= 18`
* Uma conta ativa do NoimosAI ([cadastre-se](https://noimosai.com/pt))

## Instalação

Instale a CLI globalmente com o gerenciador de pacotes de sua preferência.

```bash theme={null}
pnpm add -g @agos-labs/noimosai-cli
```

```bash theme={null}
npm install -g @agos-labs/noimosai-cli
```

Depois da instalação, o comando `noimosai` ficará disponível no shell.

## Início rápido

### 1. Fazer login

```bash theme={null}
noimosai login
```

Você pode se autenticar de duas formas:

* **Login pelo navegador (OAuth)** — abre o navegador para concluir a autenticação.
* **Chave de API** — usa uma chave criada nas configurações da equipe do NoimosAI.

Para ambientes não interativos, como CI/CD:

```bash theme={null}
noimosai login --api-key "$NOIMOS_API_KEY"
```

### 2. Iniciar um chat

```bash theme={null}
noimosai chat
```

Esse comando abre uma sessão interativa com o agente do NoimosAI. A partir daí você pode pedir análises, solicitar conteúdos ou refinar resultados.

<img src="https://mintcdn.com/agoslabstechnologiesfzco/XnfG2kcuyhJLnWAS/public/developers/cli/chat-session.png?fit=max&auto=format&n=XnfG2kcuyhJLnWAS&q=85&s=c79ea5a1e3c586123db384f4b970448c" alt="Sessão de chat do NoimosAI CLI em execução no terminal" style={{ border: '1px solid #e5e7eb', borderRadius: '8px', marginBottom: '1rem' }} width="376" height="266" data-path="public/developers/cli/chat-session.png" />

### 3. Ver todos os comandos

```bash theme={null}
noimosai --help
```

Use `--help` em qualquer comando para ver todas as opções disponíveis na versão instalada.

## Comandos

### Autenticação

* `noimosai login` — login interativo via OAuth no navegador ou chave de API
* `noimosai login --oauth` — força OAuth no navegador
* `noimosai login --api-key <key>` — login não interativo com chave de API
* `noimosai logout` — remove credenciais salvas

### `chat`

* `noimosai chat` — inicia uma sessão interativa de chat
* `noimosai chat -p "<message>"` — envia um prompt único
* `noimosai chat -r <session-id>` — retoma uma sessão anterior
* `noimosai chat -p "<message>" -o json` — saída JSON para scripts
* `noimosai chat -w <workspace-id>` — substitui o workspace padrão

### Publicação

Use `noimosai post` para visualizar, publicar imediatamente ou agendar conteúdo a partir de `posts.json`.

```bash theme={null}
noimosai post posts.json --dry-run                     # Visualizar o que seria enviado
noimosai post posts.json --now                         # Publicar imediatamente
noimosai post posts.json --schedule "2026-04-10 09:00" # Agendar publicação
noimosai post posts.json --now -o json                 # Resultado JSON para scripts
```

`posts.json` normalmente é gerado por uma sessão de chat. Se você criar o arquivo manualmente, o esquema é este:

```jsonc theme={null}
{
  "version": "1",
  "metadata": { "generatedAt": "2026-04-27T09:00:00Z" },
  "posts": [
    {
      "platform": "WordPress",
      "dataKey": "wpPostData",
      "providerAccountId": "...",
      "textBlocks": [{ "text": "..." }],
      "media": []
    }
  ]
}
```

O campo `dataKey` é o que realmente define o destino da publicação.

| Plataforma  | `dataKey`           |
| ----------- | ------------------- |
| X (Twitter) | `xPostData`         |
| Threads     | `thPostData`        |
| Facebook    | `fbPostData`        |
| Instagram   | `igPostData`        |
| YouTube     | `ytPostData`        |
| LinkedIn    | `linkedinPostData`  |
| TikTok      | `ttPostData`        |
| Bluesky     | `blueskyPostData`   |
| Pinterest   | `pinterestPostData` |
| Note        | `notePostData`      |
| WordPress   | `wpPostData`        |

### Workspaces e integrações

* `noimosai workspace list` — lista os workspaces aos quais você tem acesso
* `noimosai integration list` — lista as integrações externas conectadas

### Configuração

* `noimosai config show` — mostra a configuração atual
* `noimosai config get <key>` — lê um valor de configuração
* `noimosai config set <key> <val>` — define um valor de configuração
* `noimosai config path` — imprime o caminho do arquivo de configuração

### Opções globais

* `-o, --output <text|json>` — formato de saída (`text` ou `json`)
* `--help` — mostra ajuda para qualquer comando ou subcomando

## Uso em CI ou com agentes

A CLI foi pensada tanto para pessoas quanto para automação.

```bash theme={null}
# Login headless
noimosai login --api-key "$NOIMOS_API_KEY" -o json

# Prompt único com saída JSON
noimosai chat -p "Draft a LinkedIn post about our launch" -o json

# Dry-run antes da publicação
noimosai post posts.json --dry-run
noimosai post posts.json --now -o json
```

## Solução de problemas

* **`Cannot find package 'zod'`** — a instalação global está antiga; reinstale a CLI.
* **`Not authenticated`** — execute `noimosai login` novamente.
* **`Workspace ID not configured`** — faça login outra vez ou passe `-w <workspace-id>` no comando.

## Relacionado

* [O que é NoimosAI?](/pt/help-center/getting-started/what-is-noimosai)
* [Servidor MCP do NoimosAI](/pt/developers/mcp/overview)
* [Pacote npm](https://www.npmjs.com/package/@agos-labs/noimosai-cli)
