> 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-vm/list.md).

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