# Listar todos los comandos

> plazbot commands: árbol completo de comandos con sus argumentos y opciones, también en JSON para agentes de IA

Fuente: https://developers.plazbot.com/cli/ia/commands/

### Listar todos los comandos

Muestra todos los comandos del CLI con sus argumentos y su descripción. Con `--json` devuelve el árbol completo, con cada opción, para que un script o un agente de IA descubra qué puede hacer sin leer la documentación. Es el equivalente a `stripe --map json`. También funciona como `plazbot map`.

```bash
plazbot commands [--json]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| JSON | `--json` | No | Imprime el árbol de comandos en JSON |

Los comandos y opciones internos (ocultos en `--help`) no aparecen.

### Ejemplos

```bash
# Ver el árbol de comandos
plazbot commands

# Todos los comandos, argumentos y opciones en JSON
plazbot commands --json

# Solo las rutas de los comandos
plazbot commands --json | jq -r '.commands[].command'
```

### Resultado

```text
plazbot contacts  Read and update contacts (CRM)
  plazbot contacts list  List contacts (the inbox order: newest activity first)
  plazbot contacts get <contactId>  Get a contact with all its fields
  plazbot contacts search  Find contacts by phone number or email
  ...
plazbot api <method> <path>  Send an authenticated request to any Plazbot API endpoint

Run 'plazbot <command> --help' for options and examples.
```

### Salida JSON

```json
{
"version": "0.6.0",
"commands": [
  {
    "command": "plazbot contacts get",
    "description": "Get a contact with all its fields",
    "aliases": [],
    "arguments": [
      { "name": "contactId", "required": true, "variadic": false, "description": "Contact ID" }
    ],
    "options": [
      { "flags": "--json", "description": "Output machine-readable JSON" },
      { "flags": "-w, --workspace <id>", "description": "Workspace ID (default: the active workspace)" },
      { "flags": "-z, --zone <zone>", "description": "Zone LA or EU (default: the active zone)" }
    ],
    "subcommands": []
  }
]
}
```

| Campo | Descripción |
|-------|-------------|
| `command` | Comando completo, ej. `plazbot contacts get` |
| `aliases` | Nombres alternativos (`contact`, `map`...) |
| `arguments` | Argumentos posicionales y si son obligatorios |
| `options` | Flags visibles, con `default` y `choices` cuando los tienen |
| `subcommands` | Nombres de los subcomandos (vacío en los comandos finales) |

Ver también: [Usar el CLI con IA y scripts](https://developers.plazbot.com/cli/ia/scripting) y [`plazbot skill`](https://developers.plazbot.com/cli/ia/skill).