wednesdayai nodes
Manage paired nodes (devices) and invoke node capabilities.
Related:
- Nodes overview: Nodes
- Camera: Camera nodes
- Images: Image nodes
--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
--params <json>: JSON object string (default{}).--invoke-timeout <ms>: node invoke timeout (default15000).--idempotency-key <key>: optional idempotency key.
Exec-style defaults
nodes run mirrors the model’s exec behavior (defaults + approvals):
- Reads
tools.exec.*(plusagents.list[].tools.exec.*overrides). - Uses exec approvals (
exec.approval.request) before invokingsystem.run. --nodecan be omitted whentools.exec.nodeis set.- Requires a node that advertises
system.run(macOS companion app or headless node host).
--cwd <path>: working directory.--env <key=val>: env override (repeatable). Note: node hosts ignorePATHoverrides (andtools.exec.pathPrependis not applied to node hosts).--command-timeout <ms>: command timeout.--invoke-timeout <ms>: node invoke timeout (default30000).--needs-screen-recording: require screen recording permission.--raw <command>: run a shell string (/bin/sh -lcorcmd.exe /c). In allowlist mode on Windows node hosts,cmd.exe /cshell-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.