> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-notebook/list.md).

# list

The cldkctl notebook list command retrieves a list of all Jupyter Notebooks available in your environment. It displays key information such as notebook name, namespace, GPU type, storage, memory, status, and creation time.

## Usage

```
cldkctl notebook list [flags]
```

## Aliases

```
list, ls
```

## Steps

Follow the steps below to run and view the result of this command:

1. If your organization has multiple projects, identify the Project ID from the Project List section.
2. Run the following command in your terminal:

```
cldkctl notebook list
```

3. Wait a few seconds for the system to fetch the data.
4. Review the list of notebooks displayed in the terminal, which includes details such as name, namespace, GPU type, and status.

<figure><img src="/files/Cmbj3SFm3MLBglvz3iQ1" alt=""><figcaption></figcaption></figure>

| Column       | Description                                                         |
| ------------ | ------------------------------------------------------------------- |
| Name         | The name of the Jupyter Notebook.                                   |
| Namespace    | The namespace in which the notebook is deployed.                    |
| GPU Type     | The type of GPU assigned to the notebook.                           |
| GPU          | The number of GPUs allocated.                                       |
| CPU          | The number of CPUs allocated.                                       |
| Storage      | The type of storage used for the notebook.                          |
| Storage Size | The allocated storage capacity.                                     |
| Memory       | The total memory assigned to the notebook.                          |
| Status       | The current status of the notebook (e.g., Pending, Running).        |
| Running      | Indicates whether the notebook is currently active (true or false). |

## Flags

{% hint style="info" %}
This command supports [global flags](/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details
{% endhint %}

| Flag                 | Description                                 |
| -------------------- | ------------------------------------------- |
| -h, --help           | Help for the list command.                  |
| -p, --project string | Specify the project ID to filter notebooks. |