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

# Nodes

# `fluffbuzz nodes`

Manage paired nodes (devices) and invoke node capabilities.

Related:

* Nodes overview: [Nodes](/nodes)
* Camera: [Camera nodes](/nodes/camera)
* Images: [Image nodes](/nodes/images)

Common options:

* `--url`, `--token`, `--timeout`, `--json`

## Common commands

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fluffbuzz nodes list
fluffbuzz nodes list --connected
fluffbuzz nodes list --last-connected 24h
fluffbuzz nodes pending
fluffbuzz nodes approve <requestId>
fluffbuzz nodes reject <requestId>
fluffbuzz nodes rename --node <id|name|ip> --name <displayName>
fluffbuzz nodes status
fluffbuzz nodes status --connected
fluffbuzz nodes status --last-connected 24h
```

`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`).

Approval note:

* `fluffbuzz nodes pending` only needs pairing scope.
* `fluffbuzz nodes approve <requestId>` inherits extra scope requirements from the
  pending request:
  * commandless request: pairing only
  * non-exec node commands: pairing + write
  * `system.run` / `system.run.prepare` / `system.which`: pairing + admin

## Invoke

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fluffbuzz nodes invoke --node <id|name|ip> --command <command> --params <json>
```

Invoke flags:

* `--params <json>`: JSON object string (default `{}`).
* `--invoke-timeout <ms>`: node invoke timeout (default `15000`).
* `--idempotency-key <key>`: optional idempotency key.
* `system.run` and `system.run.prepare` are blocked here; use the `exec` tool with `host=node` for shell execution.

For shell execution on a node, use the `exec` tool with `host=node` instead of `fluffbuzz nodes run`.
The `nodes` CLI is now capability-focused: direct RPC via `nodes invoke`, plus pairing, camera,
screen, location, canvas, and notifications.