---
title: List workspaces
description: Every workspace you belong to, with your role in each.
cli_command: wiblo workspaces list
canonical_url: https://wiblo.app/docs/developers/cli/workspaces/workspaces-list
last_updated: 2026-07-28T17:12:38+02:00
md_url: https://wiblo.app/docs/developers/cli/workspaces/workspaces-list.md
---

# List workspaces

`$ wiblo workspaces list`

## Usage

```bash
wiblo workspaces list
```

```text
$ wiblo workspaces list

  SLUG           NAME           ROLE
  acme-studio    Acme Studio    owner
  side-project   Side Project   member

Run wiblo workspaces use <slug> to set the active workspace.
```

`ls` is an alias, and `list` is the default — `wiblo ws` does the same thing.

## Flags

| Flag | Description |
| --- | --- |
| `--json` | Print an array of `{ "id", "slug", "name", "role" }`. |

## Behaviour

- User-scoped: needs a personal token; a workspace API key gets `403 permission_denied`.
- With no workspaces yet, the CLI points you at the dashboard to create one.