Pin a compute node for the session (or pass `auto` to re-enable control-plane /nodes/recommend routing).
/use-node <NAME|auto>## Overview `/use-node` pins the session's compute routing to a specific node, or returns routing to automatic mode. When pinned, every subsequent SQL query runs against the named node with no recommend hop; when `auto`, the control plane picks a worker per query. ## Behavior - The name can be a display name or an `entity_ref`. Matching is case-insensitive. - On success, the shell renders a confirmation Detail card with the node's URL and status, and `compute_url` in the session config is updated. `compute_url_explicit` is set and `compute_url_auto` is cleared. - On failure (unknown name), the card lists up to five known nodes as drill-in suggestions. - `/use-node auto` sets `compute_url_auto = true` and clears `compute_url_explicit`; subsequent queries flow through the control plane's recommend endpoint regardless of prior explicit pins. - Auth is refreshed before the node lookup, so an expired token will not cause a silent fallback. ## Compatibility - The session-level pin is separate from the per-invocation `--node` flag on `delta-forge-cli query` and `delta-forge-cli run`. The flag overrides this pin for that one call only.
/use-node prod-worker-01/use-node auto/use-node wrk_abc123