# list

The cldkctl vm list command retrieves a list of all virtual machines (VMs) in your cluster. This command displays essential details such as VM name, status, readiness, and age.

## Usage

```
cldkctl vm list [flags]
```

## Aliases

```
list, ls
```

## Steps

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

1. Run the following command in your terminal:

```
cldkctl vm list
```

2. Wait for the command to execute. The system will fetch and display all active VMs under your current project or namespace.
3. Review the output table that contains essential details, including the VM namespace, name, status, readiness, and age.
4. Use the flags as needed, for example, --project to filter the results by a specific project ID.

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

| Column    | Description                                                   |
| --------- | ------------------------------------------------------------- |
| Namespace | Indicates the namespace in which the virtual machine resides. |
| Name      | The name of the virtual machine.                              |
| Status    | Shows the current state of the VM.                            |
| Ready     | Displays whether the VM is ready or not.                      |
| Age       | Indicates how long ago the virtual machine was created.       |

## 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 vm list command. |
| -p, --project string | Specify the project ID.       |


---

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