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

# Plazbot Studio

> REPL conversacional para crear, mantener y diagnosticar agentes de IA desde tu terminal

## Que es Studio

**Plazbot Studio** es un modo conversacional integrado al CLI que te permite gestionar agentes de IA hablando en lenguaje natural. En lugar de memorizar comandos, le pides cambios y Studio los aplica usando herramientas internas, mostrandote cada paso con streaming en tiempo real.

Es la misma experiencia del modal Studio del producto web, pero corriendo dentro de tu terminal — al estilo Claude Code.

### Para que sirve

* **Crear agentes** describiendo lo que necesitas (sin wizard, sin formularios)
* **Editar prompts, herramientas, fallbacks** con una sola frase
* **Diagnosticar** un agente y recibir un reporte con issues priorizadas
* **Listar, cargar y guardar** agentes desde el chat
* **Conectar WhatsApp** sin salir del REPL
* **Compactar** la conversacion para sesiones largas sin perder contexto

<Tip>
  Los cambios que aplicas en Studio (web o CLI) se sincronizan al instante. Puedes empezar en el navegador y terminar en la terminal sin perder estado.
</Tip>

### Dos modos de uso

<CardGroup cols={2}>
  <Card title="REPL interactivo" icon="terminal" href="/cli/studio/repl">
    `plazbot studio` abre un TUI con chat, panel JSON y atajos de teclado.
  </Card>

  <Card title="One-shot" icon="bolt" href="/cli/studio/ask">
    `plazbot studio ask "..."` ejecuta una sola consulta y sale, ideal para scripts.
  </Card>
</CardGroup>

### Inicio rapido

```bash theme={null}
# 1. Asegurate de tener credenciales inicializadas
plazbot init -e tu@email.com -k eyJhbG... -w wok_Zo5T... -z LA

# 2. Abre el REPL
plazbot studio

# 3. Habla con tu agente
> Crea un agente de ventas para WhatsApp que conozca mi catalogo
```

### Indice de Studio

<CardGroup cols={2}>
  <Card title="Modo REPL" icon="terminal" href="/cli/studio/repl">
    Layout, panel JSON, streaming y comandos de la sesion interactiva.
  </Card>

  <Card title="Modo One-shot" icon="bolt" href="/cli/studio/ask">
    Ejecutar una consulta puntual y salir. Soporta NDJSON.
  </Card>

  <Card title="Slash Commands" icon="slash" href="/cli/studio/slash-commands">
    Catalogo completo de comandos `/...` con ejemplos.
  </Card>

  <Card title="Atajos de teclado" icon="keyboard" href="/cli/studio/atajos">
    Esc, Ctrl+C, Tab y otros shortcuts del TUI.
  </Card>

  <Card title="Casos de uso" icon="lightbulb" href="/cli/studio/casos-de-uso">
    Ejemplos reales: crear, diagnosticar, conectar WhatsApp.
  </Card>

  <Card title="Errores comunes" icon="triangle-exclamation" href="/cli/studio/errores">
    401, 403, 429, abort, sin credenciales y como resolverlos.
  </Card>
</CardGroup>

### Requisitos

* **Node.js** >= 18.17.0
* **Plazbot CLI** >= 0.3.0
* Credenciales inicializadas con `plazbot init`
* Terminal moderno con soporte ANSI (iTerm2, Alacritty, Windows Terminal, VSCode integrated)

<Warning>
  Studio requiere Node 18+ porque usa `fetch` nativo, `ReadableStream` y modulos ESM. En versiones anteriores el comando aborta con un mensaje de version no soportada.
</Warning>