# swarmops ws list

> Release: 0.11.0 · Last changed: 2026-11-08 · Source: https://github.com/KeiaiLab/SwarmOps/blob/stable/docs/reference/commands/ws-list.md

List the store's workspaces.

```yaml
title: "swarmops ws list"
description: "List the store's workspaces."
group: "workspaces"
since: "0.3.0"
mutates: false
identity_required: false
mcp_tool: "ws_list"
envelope_op: "ws_list"
exit_codes: [0]
errors: []
syntax: "swarmops ws list [OPTIONS]"
```

## Syntax

```text
swarmops ws list [OPTIONS]
```

## Required arguments

None.

## Optional arguments

The command also takes the [global options](../cli.md#global-options).

### `--check`

Syntax: `--check`.

Also open each, and report one whose directory is gone as an orphan.

## Examples

### CLI

No recorded example yet.

### MCP

No recorded example yet.

## Return information

`result` is a `WsList` (`swarmops schema WsList` prints its JSON Schema).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `workspaces` | `array of WsInfo` | yes | The workspaces. |

Envelope `op`: `ws_list`.

Exit codes:

- `0`: Success.

## Errors

No golden step shows this command failing yet.

Any command that opens a store may also fail with a store error, such as [`E_NOT_A_REPO`](../errors.md#e_not_a_repo), [`E_IO`](../errors.md#e_io) or [`E_STORE_CORRUPT`](../errors.md#e_store_corrupt); a command line the grammar refuses is [`E_INVALID_ARG`](../errors.md#e_invalid_arg) (exit 2).

## See also

- [`swarmops ws create`](ws-create.md)
- [`swarmops ws status`](ws-status.md)
- [`swarmops ws diff`](ws-diff.md)
- [`swarmops ws commit`](ws-commit.md)
- [`swarmops ws rebase`](ws-rebase.md)
- [`swarmops ws resolve`](ws-resolve.md)
- [`swarmops ws land`](ws-land.md)
- [`swarmops ws materialize`](ws-materialize.md)
- [`swarmops ws discard`](ws-discard.md)
- [`swarmops ws snapshot`](ws-snapshot.md)
- [`swarmops ws info`](ws-info.md)
- [`swarmops ws delete`](ws-delete.md)
- [`swarmops ws hook`](ws-hook.md)
- [CLI reference](../cli.md)
- [Error codes](../errors.md)