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

01plazbot 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

01# Listar todos los workers
02plazbot workers list
03 
04# Solo los schedules
05plazbot workers list -t schedule
06 
07# Solo los workers con errores
08plazbot workers list -s error
09 
10# Webhooks activos en JSON (para obtener sus URLs)
11plazbot workers list -t webhook -s active --json

Resultado

text

01  Workers (2)
02  ────────────────────────────────────────
03┌─────────────────┬─────────┬────────┬────────────┬────────┬──────────┬───────────────────────┐
04│ Name            │ Type    │ Status │ Executions │ Errors │ Duration │ Last execution        │
05├─────────────────┼─────────┼────────┼────────────┼────────┼──────────┼───────────────────────┤
06│ get-stock       │ tool    │ active │ 128        │ 0      │ 245ms    │ Oct 6, 2026, 03:12 PM │
07├─────────────────┼─────────┼────────┼────────────┼────────┼──────────┼───────────────────────┤
08│ stripe-payments │ webhook │ error  │ 42         │ 3      │ 180ms    │ Oct 6, 2026, 02:03 PM │
09└─────────────────┴─────────┴────────┴────────────┴────────┴──────────┴───────────────────────┘
10 
11  Workers with errors:
12    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

01[
02  {
03    "id": "...",
04    "name": "stripe-payments",
05    "type": "webhook",
06    "status": "active",
07    "description": "Recibe pagos confirmados",
08    "cronExpression": null,
09    "webhookUrl": "https://...",
10    "executionCount": 42,
11    "errorCount": 3,
12    "avgDurationMs": 180,
13    "lastExecutedAt": "2026-10-06T19:03:00Z",
14    "lastError": null,
15    "createdAt": "2026-09-30T15:20:00Z",
16    "updatedAt": "2026-10-06T19:03:00Z"
17  }
18]

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot 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.