/nodes

List compute nodes with status, load, workspace affinity, and a click-through to pin each one.

Category: slash-commands

Syntax

/nodes

Description

## Overview `/nodes` lists every compute node the control plane reports via `/list-compute-nodes` and marks the one the CLI is currently routing to. Each row is a drill-in: `/open N` runs `/use-node <name>` against that node, pinning subsequent SQL to it. ## Behavior - Requires control-plane auth. The token is refreshed before the call. - Columns: name, status (ready, busy, unreachable), current URL, workspace affinity (if any), and whether this node is currently active for the CLI. - The active node is marked with an arrow prefix so it is easy to spot. - To switch active node, use `/open N` or run `/use-node <name>` directly. To return to control-plane auto-routing, use `/use-node auto`.

Examples

/nodes
:nodes

See Also

Open in interactive docs →   DeltaForge home →