> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodepick.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Nodes (np node list)

> List all compute nodes in your organization using the np node list CLI command.

List all compute nodes currently provisioned in your organization, along with their states and pre-formatted SSH connect commands.

## Syntax

```bash theme={null}
np node list [options]
```

## Options

| Option     | Short | Description                       | Default |
| ---------- | ----- | --------------------------------- | ------- |
| `--format` | `-f`  | Output format (`table` or `json`) | `table` |

## Output Fields

* **VM UUID**: Unique virtual machine identifier.
* **Name**: Display name assigned to the node.
* **State**: Current operational state (e.g. `running`, `stopped`).
* **SSH Connect**: Prepared SSH command for connecting directly to the node.

## Examples

<CodeGroup>
  ```bash Table View theme={null}
  # Interactive Rich table output (default)
  np node list
  ```

  ```bash JSON Output theme={null}
  # Structured JSON for parsing and scripting
  np node list -f json
  ```
</CodeGroup>

## Related Commands

<CardGroup cols={2}>
  <Card title="Get Node Details" icon="magnifying-glass" href="/cli-reference/nodes/get">
    Fetch full hardware specs and connection credentials for a specific node.
  </Card>

  <Card title="Power Options" icon="power-off" href="/cli-reference/nodes/power">
    Boot, shutdown, or reboot nodes.
  </Card>
</CardGroup>