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

# Inspect nodes

> List connected capacity and watch node changes.

Use `idyl node get` to inspect nodes in a subnet.

## List connected nodes

```bash theme={null}
idyl node get --subnet <subnet>
```

Output similar to:

```text theme={null}
DISPLAY NAME   NODE ID                                           STATUS
gpu-1          63GtQFnlN3-lsHQBW6HlJZblsHPy8n5oYO1lG0qZQd4      connected
```

The display name is presentation metadata set by the provider account. The full
node ID remains the canonical identifier and is always available for copying.
When a node is unnamed, its node ID is shown as the primary value.

Use the current context subnet:

```bash theme={null}
idyl node get
```

## Include disconnected nodes

```bash theme={null}
idyl node get --subnet <subnet> --all
```

## Watch node changes

```bash theme={null}
idyl node get --subnet <subnet> --watch
```

Renaming a node produces updated watch output without requiring the node to
reconnect, including when a disconnected node remains available through
`--all`.

## Get one node

```bash theme={null}
idyl node get <node-id> --subnet <subnet>
```

Use the canonical node ID. Display names are not accepted as lookup values, and
duplicate display names are allowed.

## JSON output

```bash theme={null}
idyl node get --subnet <subnet> -o json
```

Runtime JSON preserves both fields: `node_id` is the canonical identifier and
the optional `display_name` is the provider-defined label.

Seeing a display name in a subnet does not grant permission to edit the provider
node. Rename controls belong to the account that owns the node.