# Listar workers

> Muestra los workers del workspace con su estado y métricas de ejecución.

Fuente: https://developers.plazbot.com/cli/workers/list/

### Listar workers

Muestra los workers desplegados en el workspace, con su tipo, estado, número de ejecuciones y errores. Puedes filtrar por tipo y estado.

```bash
plazbot workers list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Tipo | `-t, --type <type>` | No | Filtra por tipo: `tool`, `worker`, `sync`, `schedule`, `webhook`. |
| Estado | `-s, --status <status>` | No | Filtra por estado: `active`, `inactive`, `error`. |
| JSON | `--json` | No | Imprime la lista como JSON (incluye `webhookUrl`, `cronExpression` y `lastError`). |

### Ejemplos

```bash
# Listar todos los workers
plazbot workers list

# Solo los schedules
plazbot workers list -t schedule

# Solo los workers con errores
plazbot workers list -s error

# Webhooks activos en JSON (para obtener sus URLs)
plazbot workers list -t webhook -s active --json
```

### Resultado

```text
Workers (2)
────────────────────────────────────────
┌─────────────────┬─────────┬────────┬────────────┬────────┬──────────┬───────────────────────┐
│ Name            │ Type    │ Status │ Executions │ Errors │ Duration │ Last execution        │
├─────────────────┼─────────┼────────┼────────────┼────────┼──────────┼───────────────────────┤
│ get-stock       │ tool    │ active │ 128        │ 0      │ 245ms    │ Oct 6, 2026, 03:12 PM │
├─────────────────┼─────────┼────────┼────────────┼────────┼──────────┼───────────────────────┤
│ stripe-payments │ webhook │ error  │ 42         │ 3      │ 180ms    │ Oct 6, 2026, 02:03 PM │
└─────────────────┴─────────┴────────┴────────────┴────────┴──────────┴───────────────────────┘

Workers with errors:
  stripe-payments: Invalid signature
```

| Columna | Descripción |
|---------|-------------|
| Name | Nombre del worker. |
| Type | `tool`, `worker`, `sync`, `schedule` o `webhook`. |
| Status | `active`, `inactive` o `error`. |
| Executions | Total de ejecuciones. |
| Errors | Total de ejecuciones con error. |
| Duration | Duración promedio por ejecución (`—` si aún no se ejecutó). |
| Last execution | Fecha de la última ejecución. |

Si hay workers en estado `error`, debajo de la tabla se muestra el último error de cada uno. Sin workers, el CLI imprime `No workers found in this workspace` y sugiere `plazbot workers deploy`.

### Salida JSON

```json
[
{
  "id": "...",
  "name": "stripe-payments",
  "type": "webhook",
  "status": "active",
  "description": "Recibe pagos confirmados",
  "cronExpression": null,
  "webhookUrl": "https://...",
  "executionCount": 42,
  "errorCount": 3,
  "avgDurationMs": 180,
  "lastExecutedAt": "2026-10-06T19:03:00Z",
  "lastError": null,
  "createdAt": "2026-09-30T15:20:00Z",
  "updatedAt": "2026-10-06T19:03:00Z"
}
]
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
| `error: option '-t, --type <type>' argument 'x' is invalid. Allowed choices are tool, worker, sync, schedule, webhook.` | Tipo no válido. | Usa uno de los valores permitidos. |