# 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="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FR9ne6pn3BDu766eCCtD8%2Funknown.png?alt=media&#x26;token=51141fd1-7f3f-4209-a195-7fddd95d2d91" 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](https://docs.cloudeka.ai/cloudeka-api-list/global-flags). 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. |