Cambiar de workspace | Plazbot Docs

Workspaces

Todos los comandos del CLI trabajan sobre el workspace activo. Si eres miembro de varios, puedes listarlos y cambiar de uno a otro sin volver a iniciar sesión.

Requiere una sesión iniciada con plazbot login. Con plazbot init sin --user-id el CLI no conoce tu usuario y no puede listar workspaces; con variables de entorno, cambia PLAZBOT_WORKSPACE_ID.

workspace list

Lista los workspaces de los que eres miembro: solo los activos, cuya invitación ya aceptaste y de la misma zona de tu sesión.

bash

01plazbot workspace list [--json]

Parámetros

Parámetro	Flag	Requerido	Descripción
JSON	`--json`	No	Imprime la lista en JSON, con `active: true` en el workspace activo

Ejemplos

bash

01# Listar tus workspaces (● marca el activo)
02plazbot workspace list
03 
04# Obtenerlos en JSON
05plazbot workspace list --json

Resultado

text

01┌───┬──────────────────┬───────────────┐
02│   │ Workspace        │ ID            │
03├───┼──────────────────┼───────────────┤
04│ ● │ Mi Empresa       │ wok_AbcDef123 │
05├───┼──────────────────┼───────────────┤
06│   │ Cliente Demo     │ wok_XyzUvw456 │
07└───┴──────────────────┴───────────────┘
08  Switch with: plazbot workspace use <workspaceId>

Si no tienes workspaces, imprime No workspaces found for this account.

Salida JSON

json

01[
02  { "id": "wok_AbcDef123", "name": "Mi Empresa", "active": true },
03  { "id": "wok_XyzUvw456", "name": "Cliente Demo", "active": false }
04]

workspace use

Cambia el workspace activo. Antes de cambiarlo, comprueba que tienes acceso.

bash

01plazbot workspace use <workspaceId> [--json]

Parámetros

Parámetro	Flag	Requerido	Descripción
Workspace ID	`<workspaceId>`	Sí	ID del workspace (sale en `plazbot workspace list`)
JSON	`--json`	No	Imprime el resultado en JSON

Ejemplos

bash

01# Cambiar el workspace activo
02plazbot workspace use wok_XyzUvw456
03 
04# Cambiar desde un script
05plazbot workspace use wok_XyzUvw456 --json

Resultado

text

01  Active workspace: Cliente Demo (wok_XyzUvw456)

Salida JSON

json

01{
02  "id": "wok_XyzUvw456",
03  "name": "Cliente Demo",
04  "active": true
05}

Errores comunes

Mensaje	Causa	Solución
`You do not have access to workspace wok_...`	No eres miembro, no aceptaste la invitación o el workspace es de otra zona	Revisa tus workspaces con `plazbot workspace list`
`The session comes from environment variables.`	Las variables de entorno mandan sobre la sesión guardada	Cambia `PLAZBOT_WORKSPACE_ID`
`This session has no user attached, so workspaces cannot be listed.`	La sesión se guardó con `plazbot init` sin `--user-id`	Inicia sesión con `plazbot login`
`You are not signed in.`	No hay sesión	Ejecuta `plazbot login`

Para trabajar con un workspace de otra zona, inicia sesión en esa zona: plazbot login --zone EU (o LA).