---
title: List repos
description: The workspace repo registry and the checkouts in the current run.
cli_command: wiblo repos list
canonical_url: https://wiblo.app/docs/developers/cli/repos/repos-list
last_updated: 2026-07-28T17:12:38+02:00
md_url: https://wiblo.app/docs/developers/cli/repos/repos-list.md
---

# List repos

`$ wiblo repos list`

## Usage

```bash
wiblo repos list
```

```text
$ wiblo repos list
Workspace repos:

  NAME       PURPOSE    STATUS   CLONE URL
  website    primary    ready    https://git.wiblo.app/...

Checkouts in this run:

  FOLDER   BRANCH   COMMIT    STATE   REMOTE
  main     main     a0ec272   clean   wiblo
```

`ls` is an alias, and `list` is the default — bare `wiblo repos` lists.

## Flags

| Flag | Description |
| --- | --- |
| `--json` | Print `{ "registry": [...], "checkouts": [...] }`. |
| `--workspace` | Workspace **uuid** (default `WIBLO_WORKSPACE_ID`) for the registry half. |
| `--run` | Agent run id (default `WIBLO_RUN_ID`) for the checkouts half. |

## Behaviour

Either half is optional — outside a run you get just the registry, without a workspace id just the checkouts. Only when neither id resolves does the command error.