Skip to main content

wednesdayai nodes

Manage paired nodes (devices) and invoke node capabilities. Related: Common options:
  • --url, --token, --timeout, --json

Common commands

nodes list prints pending/paired tables. Paired rows include the most recent connect age (Last Connect). Use --connected to only show currently-connected nodes. Use --last-connected <duration> to filter to nodes that connected within a duration (e.g. 24h, 7d). nodes status adds Registered (first registration age) and Last Active columns for paired nodes. A paired node with no activity for longer than gateway.devices.staleAfterDays (default 90) shows stale in its Status cell; a connected node is never stale. Archive stale records with devices prune --stale. Pairing changes go through the gateway RPC when a gateway is running. When no gateway owns storage, nodes pending, nodes approve, nodes reject and nodes rename open the session database locally and apply the change directly. nodes status and the invoke/run commands always need a running gateway. Legacy nodes/*.json files are imported into the database on first open (see Gateway pairing storage).

Invoke / run

Invoke flags:
  • --params <json>: JSON object string (default {}).
  • --invoke-timeout <ms>: node invoke timeout (default 15000).
  • --idempotency-key <key>: optional idempotency key.

Exec-style defaults

nodes run mirrors the model’s exec behavior (defaults + approvals):
  • Reads tools.exec.* (plus agents.list[].tools.exec.* overrides).
  • Uses exec approvals (exec.approval.request) before invoking system.run.
  • --node can be omitted when tools.exec.node is set.
  • Requires a node that advertises system.run (macOS companion app or headless node host).
Flags:
  • --cwd <path>: working directory.
  • --env <key=val>: env override (repeatable). Note: node hosts ignore PATH overrides (and tools.exec.pathPrepend is not applied to node hosts).
  • --command-timeout <ms>: command timeout.
  • --invoke-timeout <ms>: node invoke timeout (default 30000).
  • --needs-screen-recording: require screen recording permission.
  • --raw <command>: run a shell string (/bin/sh -lc or cmd.exe /c). In allowlist mode on Windows node hosts, cmd.exe /c shell-wrapper runs require approval (allowlist entry alone does not auto-allow the wrapper form).
  • --agent <id>: agent-scoped approvals/allowlists (defaults to configured agent).
  • --ask <off|on-miss|always>, --security <deny|allowlist|full>: overrides.