---
title: "List"
description: "List all diagrams in your Merfolk account."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.merfolk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List

## Usage

```sh
merfolk diagrams list [flags]
```

## Description

Lists all diagrams owned by or shared with the authenticated user.

## Flags

| Flag     | Description            |
| -------- | ---------------------- |
| `--json` | Output results as JSON |

## Examples

```sh
# List diagrams in table format
merfolk diagrams list

# List diagrams as JSON (useful for scripting)
merfolk diagrams list --json
```

## Output

Default table output:

```
ID          TITLE                 UPDATED
abc123      My architecture       2 hours ago
def456      Auth flow             1 day ago
```

With `--json`:

```json
[
  {
"id": "abc123",
"title": "My architecture",
"updatedAt": "2024-01-15T10:30:00Z"
  }
]
```

## Exit codes

| Code | Meaning                                 |
| ---- | --------------------------------------- |
| `0`  | Success                                 |
| `2`  | Not authenticated — run `merfolk login` |

Source: https://docs.merfolk.io/cli/diagrams/list/index.mdx