# 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. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-notebook/list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.