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

> Chatea con el agente de NoimosAI y publica posts sociales o artículos largos directamente desde tu terminal.

## Descripción general

NoimosAI CLI (`@agos-labs/noimosai-cli`) te permite operar tu espacio de trabajo de NoimosAI desde la línea de comandos. Puedes hablar con el agente de NoimosAI para análisis de marketing, generación de contenido y trabajo de SEO, publicar tanto posts cortos de redes sociales como artículos largos (WordPress, note) en plataformas conectadas y revisar espacios de trabajo e integraciones sin salir de la terminal.

El paquete se publica en npm como [`@agos-labs/noimosai-cli`](https://www.npmjs.com/package/@agos-labs/noimosai-cli).

## Funciones principales

* **Chat** — conversaciones interactivas o de una sola ejecución con el agente de NoimosAI.
* **Publicación** — envío de posts sociales y artículos largos a cuentas conectadas.
* **Inspección de espacios de trabajo e integraciones** — consulta de espacios y cuentas conectadas desde la CLI.
* **Automatizable** — los comandos importantes aceptan flags y `--output json` para resultados legibles por máquina.

## Comandos más comunes

Estos comandos te permiten entender rápidamente qué hace la CLI.

```bash theme={null}
noimosai login                              # Iniciar sesión (OAuth en navegador o clave API)
noimosai chat                               # Iniciar un chat interactivo
noimosai chat -p "Draft a launch post"      # Enviar un prompt único
noimosai chat -p "..." -o json              # Prompt único con salida JSON
noimosai post posts.json --dry-run          # Previsualizar una publicación
noimosai post posts.json --now              # Publicar inmediatamente
noimosai workspace list                     # Listar espacios de trabajo disponibles
noimosai integration list                   # Listar cuentas conectadas
```

## Plataformas de publicación compatibles

Tanto los posts cortos como los artículos largos pueden publicarse desde un único archivo `posts.json`.

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

## Requisitos

* Node.js `>= 18`
* Una cuenta activa de NoimosAI ([registrarse](https://noimosai.com/es))

## Instalación

Instala la CLI de forma global con tu gestor de paquetes preferido.

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

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

Después de la instalación, el comando `noimosai` estará disponible en tu shell.

## Inicio rápido

### 1. Iniciar sesión

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

Puedes autenticarte de dos maneras:

* **Inicio de sesión en navegador (OAuth)** — abre el navegador para completar la autenticación.
* **Clave API** — usa una clave API generada en la configuración del equipo de NoimosAI.

Para entornos no interactivos como CI/CD:

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

### 2. Iniciar un chat

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

Esto abre una sesión interactiva con el agente de NoimosAI. Desde ahí puedes pedir análisis, solicitar contenido o iterar 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="Sesión de chat de NoimosAI CLI ejecutándose en la 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 los comandos

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

Usa `--help` en cualquier subcomando para ver todas las opciones disponibles en la versión que tienes instalada.

## Comandos

### Autenticación

* `noimosai login` — inicio de sesión interactivo mediante OAuth en navegador o clave API
* `noimosai login --oauth` — forzar OAuth en navegador
* `noimosai login --api-key <key>` — inicio de sesión no interactivo con clave API
* `noimosai logout` — eliminar credenciales guardadas

### `chat`

* `noimosai chat` — iniciar una sesión de chat interactiva
* `noimosai chat -p "<message>"` — enviar un prompt único
* `noimosai chat -r <session-id>` — reanudar una sesión anterior
* `noimosai chat -p "<message>" -o json` — salida JSON para scripts
* `noimosai chat -w <workspace-id>` — sobrescribir el espacio de trabajo por defecto

### Publicación

Usa `noimosai post` para revisar, publicar inmediatamente o programar contenido desde `posts.json`.

```bash theme={null}
noimosai post posts.json --dry-run                     # Previsualizar lo que se enviaría
noimosai post posts.json --now                         # Publicar inmediatamente
noimosai post posts.json --schedule "2026-04-10 09:00" # Programar la publicación
noimosai post posts.json --now -o json                 # Resultado JSON para scripts
```

`posts.json` normalmente se genera desde una sesión de chat. Si lo escribes a mano, este es el esquema:

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

El campo `dataKey` controla el destino real de publicación.

| 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`        |

### Espacios de trabajo e integraciones

* `noimosai workspace list` — listar los espacios de trabajo a los que tienes acceso
* `noimosai integration list` — listar integraciones externas conectadas

### Configuración

* `noimosai config show` — mostrar la configuración actual
* `noimosai config get <key>` — leer un valor de configuración
* `noimosai config set <key> <val>` — establecer un valor de configuración
* `noimosai config path` — mostrar la ruta del archivo de configuración

### Opciones globales

* `-o, --output <text|json>` — formato de salida (`text` o `json`)
* `--help` — mostrar ayuda para cualquier comando o subcomando

## Uso en CI o con agentes

La CLI está pensada tanto para personas como para automatizaciones.

```bash theme={null}
# Inicio de sesión sin interfaz
noimosai login --api-key "$NOIMOS_API_KEY" -o json

# Prompt único con salida JSON
noimosai chat -p "Draft a LinkedIn post about our launch" -o json

# Dry-run antes de publicar
noimosai post posts.json --dry-run
noimosai post posts.json --now -o json
```

## Solución de problemas

* **`Cannot find package 'zod'`** — la instalación global es antigua; vuelve a instalar la CLI.
* **`Not authenticated`** — ejecuta `noimosai login` otra vez.
* **`Workspace ID not configured`** — vuelve a iniciar sesión o pasa `-w <workspace-id>` en el comando.

## Relacionado

* [¿Qué es NoimosAI?](/es/help-center/getting-started/what-is-noimosai)
* [Servidor MCP de NoimosAI](/es/developers/mcp/overview)
* [Paquete de npm](https://www.npmjs.com/package/@agos-labs/noimosai-cli)
