---
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-10-11T19:02:53+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

> Your active workspace is acme-studio.
```

The `✔` marks your active workspace. Without one set, the list ends with a
hint to run `wiblo workspaces use <slug>` instead.

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

## Flags

| Flag         | Description                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `--json`     | Print your membership rows as an array. Each row carries `"current": true` when it is your active workspace, `false` otherwise. |
| `--archived` | Also list the archived workspaces you own, with an `Archived` date column.                                                      |

## 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.
- If your saved active workspace is archived, or no longer exists, the list
  warns you and suggests picking a new one with `wiblo workspaces use <slug>`.