# Slash commands

> Comandos /... disponibles dentro de la sesión interactiva de Studio

Fuente: https://developers.plazbot.com/cli/studio/slash-commands/

### Slash commands

Los slash commands empiezan con `/` y se escriben en el cuadro de texto de [`plazbot studio`](https://developers.plazbot.com/cli/studio/repl), seguidos de Enter. Algunos corren localmente (`/help`, `/clear`, `/export`) y otros envían a Studio un mensaje predefinido (`/agents`, `/diagnose`). El nombre no distingue mayúsculas y los argumentos con espacios van entre comillas.

```text
/<command> [args]
```

### Lista completa

| Comando | Alias | Grupo | Qué hace |
|---------|-------|-------|----------|
| `/help` | `/?` | General | Muestra la lista de comandos y atajos |
| `/quit` | `/exit`, `/q` | General | Sale de Studio |
| `/agents` | | Agent | Lista los agentes del workspace actual |
| `/load <agentId>` | | Agent | Carga un agente por id y muestra su configuración |
| `/save` | | Agent | Guarda en el backend la configuración del agente cargado |
| `/diagnose` | | Agent | Diagnostica el agente actual y reporta lo que encuentre |
| `/export [path]` | `/download` | Agent | Escribe la configuración del agente cargado como JSON en `[path]` (por defecto `./<nombre-del-agente>.json`) |
| `/clear` | `/cls` | Session | Borra los mensajes y el historial del cuadro de texto (mantiene el agente cargado y el contador de tokens) |
| `/reset` | | Session | Reinicio total: borra mensajes, agente cargado y contador de tokens |
| `/compact` | | Session | Resume la conversación y reemplaza el historial por ese resumen |

Si escribes un comando que no existe:

```text
● Plazbot
 Unknown command: /deploy. Run /help to see the list.
```

## /help

Muestra los comandos agrupados (General, Agent, Session) y los atajos de teclado.

```text
● Plazbot
 Plazbot Studio — slash commands

 Type plain text to chat with the assistant.
 Slash commands run locally or send a templated prompt to the model.

 General
 • /help (alias: /?) — Show this help with every available command
 • /quit (aliases: /exit, /q) — Exit Studio

 Agent
 • /agents — List the agents in the current workspace
 • /load <agentId> — Load an agent by id and show its current configuration
 • /save — Save the currently loaded agent configuration to the backend
 • /diagnose — Run diagnostics on the current agent and report any issues found
 • /export [path] (alias: /download) — Write the loaded agent configuration as JSON to [path] (default: ./<agent-name>.json)

 Session
 • /clear (alias: /cls) — Clear the message history and the input history (keeps the loaded agent and token usage)
 • /reset — Full reset: clears messages, loaded agent and token usage
 • /compact — Summarize the conversation and replace history with that summary

 Keyboard shortcuts
 • Enter — send the message
 • ↑ / ↓ — browse your previous messages
 • Tab or → — accept the gray suggestion from your history
 • Esc — cancel the current response (or a pending channel connection)
 • Ctrl+C — exit Studio immediately
 ...
```

## /agents

Envía a Studio `List all agents in my workspace.` Studio usa la herramienta `list_agents` y responde con la lista.

```text
● You
 List all agents in my workspace.

● Plazbot
 You have 3 agents in this workspace:

 • Ventas WA (age_AbcDef123) - active, WhatsApp
 • Soporte L1 (age_GhiJkl456) - active, Webchat
 • Reservas (age_MnoPqr789) - inactive
 ✓ Agents listed
```

## /load

Fija el agente en la sesión (aparece en el encabezado) y pide a Studio cargarlo y mostrar su configuración. Desde ahí `/save`, `/diagnose` y `/export` trabajan sobre ese agente.

```text
/load age_AbcDef123
```

```text
● You
 Load the agent with id "age_AbcDef123" and show me its current configuration.

● Plazbot
 Loaded Ventas WA (age_AbcDef123):
 ...
 ✓ Agent loaded
```

Sin id muestra `Usage: /load <agentId>`.

## /save

Pide a Studio guardar la configuración del agente cargado (`Save this agent with its current configuration.`). Si el agente ya existe lo actualiza; si lo acabas de crear en la conversación, lo crea en tu workspace.

```text
● Plazbot
 Ventas WA was saved.
 ✓ Agent saved
```

Si no hay configuración en la sesión: `No agent configuration loaded. Create one first or use /load <id>.`

## /diagnose

Pide a Studio diagnosticar el agente actual (`Diagnose this agent and report any issues you find.`). El reporte lista los puntos a revisar ordenados por severidad (`critical`, `warning`).

```text
● Plazbot
 I found 2 points to review in Ventas WA:

 1. Critical - No timezone configured. Set the agent timezone.
 2. Warning - The prompt has no fallback instructions.
 ✓ Diagnosis complete
```

## /export

Escribe la configuración del agente cargado en un archivo JSON (no exporta la conversación). Sin argumento usa `./<nombre-del-agente>.json` en el directorio actual; acepta rutas relativas, absolutas y `~`.

```text
/export
/export ~/agentes/ventas.json
```

```text
● Plazbot
 Agent configuration exported to /Users/ana/proyecto/ventas-wa.json.

 Validate it with: plazbot agent validate /Users/ana/proyecto/ventas-wa.json
```

Si no hay configuración en la sesión: `No agent configuration loaded. Create one first or use /load <id>.` Si no se puede escribir: `Could not write the file: <motivo>`. Luego puedes validarlo con [`plazbot agent validate`](https://developers.plazbot.com/cli/agent/validate).

## /compact

Pide a Studio un resumen de la conversación (objetivo, decisiones, estado del agente y pendientes) y, al terminar, reemplaza todo el historial por ese resumen. Los siguientes mensajes parten de ahí, con menos tokens de contexto. Si aún no hay mensajes: `Nothing to compact yet.`

> **Nota:** Si cancelas con `Esc` mientras se genera el resumen, el historial no se reemplaza.

## /clear y /reset

`/clear` borra los mensajes y el historial de `↑`/`↓`, pero mantiene el agente y su configuración en la sesión, y el contador de tokens. `/reset` borra todo. Ninguno pide confirmación; si hay una respuesta en curso, la cancela.

| Comando | Mensajes | Agente cargado | Tokens |
|---------|:--------:|:--------------:|:------:|
| `/clear` | Se borran | Se mantiene | Se mantienen |
| `/compact` | Se resumen | Se mantiene | Se mantienen |
| `/reset` | Se borran | Se borra | Vuelven a 0 |

## /quit

Sale de Studio. Equivale a `Ctrl+C`.
