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

# Slash Commands

> Catalogo completo de comandos /... disponibles dentro del REPL de Studio

## Que son

Los **slash commands** son atajos que comienzan con `/` y se ejecutan dentro del REPL para hacer acciones rapidas sin escribirlas en lenguaje natural. Algunos disparan herramientas internas (como `/agents`), otros controlan la UI del TUI (como `/clear`).

Escribelos en el input y presiona Enter:

```text theme={null}
> /help
> /agents
> /load age_TZiOY...
> /diagnose
```

<Tip>
  El input tiene autocompletado: empieza con `/` y veras las opciones disponibles filtradas conforme escribes.
</Tip>

***

## Catalogo completo

| Comando          | Categoria | Descripcion                                    |
| ---------------- | --------- | ---------------------------------------------- |
| `/help`          | UI        | Muestra ayuda inline con todos los comandos    |
| `/agents`        | Accion    | Lista agentes del workspace activo             |
| `/load <id>`     | Accion    | Carga un agente por ID y abre el panel JSON    |
| `/save`          | Accion    | Persiste cambios pendientes del agente cargado |
| `/diagnose`      | Accion    | Diagnostica el agente cargado y muestra issues |
| `/export`        | Accion    | Exporta la conversacion actual a archivo `.md` |
| `/compact`       | Sesion    | Comprime el historial preservando contexto     |
| `/clear`         | UI        | Limpia la pantalla manteniendo el historial    |
| `/reset`         | Sesion    | Reinicia la sesion (borra mensajes y estado)   |
| `/quit`, `/exit` | UI        | Sale del REPL                                  |

***

## Comandos de UI

### /help

Imprime un mensaje sintetico del assistant con la lista de comandos disponibles, atajos de teclado y links a la documentacion.

```text theme={null}
> /help

Comandos disponibles:
  /agents         Listar agentes
  /load <id>      Cargar un agente
  /save           Guardar cambios
  /diagnose       Diagnosticar agente
  /compact        Comprimir historial
  /clear          Limpiar pantalla
  /reset          Reiniciar sesion
  /export         Exportar conversacion
  /quit           Salir

Atajos:
  Tab             Toggle panel
  Esc             Cancelar stream
  Ctrl+C x2       Salir
```

### /clear

Limpia el output del terminal pero **mantiene el historial** en el store. El proximo mensaje sigue teniendo contexto.

```text theme={null}
> /clear
```

### /quit / /exit

Cierra el REPL limpiamente. Equivalente a presionar `Ctrl+C` dos veces.

***

## Comandos de accion (disparan herramientas)

### /agents

Envia internamente "lista mis agentes" al backend. Studio responde con:

1. Tool-call `list_agents` (spinner)
2. Tool-result con la lista
3. Texto formateado en markdown

```text theme={null}
> /agents

✓ Consultando agentes · 0.4s

Tienes 4 agentes activos:
- Catalogo WA
- Soporte L1
- Reservas
- Demo Bot
```

### /load \<id>

Carga un agente por ID, lo deja activo en la sesion y puebla el panel JSON.

```text theme={null}
> /load age_TZiOY8xKn2...

✓ Cargando agente · 0.6s

Cargado: Catalogo WA (catalogo-wa)
Canal: WhatsApp · 8 herramientas · prompt 1.2k tokens
```

Despues de cargar, los comandos `/save` y `/diagnose` operan sobre este agente.

<Tip>
  Si no recuerdas el ID, ejecuta `/agents` primero — la respuesta incluye IDs clickeables.
</Tip>

### /save

Persiste los cambios pendientes (prompt, herramientas, fallback, etc.) que aplicaste durante la conversacion. Antes de guardar no estan en la base de datos.

```text theme={null}
> /save

✓ Validando config · 0.2s
✓ Guardando agente · 0.8s

Guardado. Version 14 publicada.
```

### /diagnose

Ejecuta un analisis completo del agente cargado: revisa prompt, herramientas, fallbacks, ejemplos, conexion del canal y mas. Devuelve un reporte priorizado.

```text theme={null}
> /diagnose

✓ Diagnosticando · 1.4s

Issues encontrados:
  [crit] Falta fallback para "no hay stock"
  [warn] Prompt usa "usted" inconsistentemente (3 ocurrencias)
  [info] 2 herramientas sin descripcion
```

El tab `diagnose` del panel se llena automaticamente con detalle de cada issue.

### /export

Exporta el historial completo de la conversacion a un archivo markdown en el directorio actual.

```text theme={null}
> /export

✓ Exportado a ./plazbot-studio-2026-06-13.md
```

Util para guardar sesiones de debugging o compartir un razonamiento con el equipo.

***

## Comandos de sesion

### /compact

Comprime el historial de la sesion en un resumen, liberando tokens del contexto sin perder la informacion clave. Util cuando la conversacion se hace muy larga.

```text theme={null}
> /compact

✓ Compactando · 0.9s

Historial compactado de 42 mensajes a 1 resumen.
Tokens liberados: ~8.4k
```

Despues de compactar, los siguientes mensajes parten desde el resumen como contexto base.

### /reset

Reinicia **toda** la sesion: borra mensajes, estado, agente cargado, panel. Como cerrar y abrir el REPL.

```text theme={null}
> /reset

Sesion reiniciada.
```

<Warning>
  `/reset` no pide confirmacion. Si necesitas conservar la conversacion, ejecuta `/export` antes.
</Warning>

***

## Comparacion rapida

| Comando    | Limpia historial | Limpia pantalla | Reinicia estado |
| ---------- | :--------------: | :-------------: | :-------------: |
| `/clear`   |        No        |        Si       |        No       |
| `/compact` |      Resume      |        No       |        No       |
| `/reset`   |        Si        |        Si       |        Si       |