# Node

URL: https://docs.hanzo.ai/docs/cli/node

> The `hanzo node` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/node) · **CLI** · [SDKs](https://docs.hanzo.ai/docs/sdks)

Your machines: the ones you own, connected and ready to take a command.

[API reference →](https://docs.hanzo.ai/docs/openapi/node)

```bash
hanzo node list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                  | What it does                                                                                                                                                                                                    |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo node connect`     | The socket a bot node dials and holds open to become invokable.                                                                                                                                                 |
| `hanzo node invoke <id>` | Ask one of your connected machines to run a command, and get its answer back.                                                                                                                                   |
| `hanzo node list`        | Returns the caller org's currently connected bot nodes: what each one calls itself, the platform it runs on, its agent version, when its socket was established, and the capabilities and commands it reported. |

### Peer

| Command                  | What it does                                                                       |
| ------------------------ | ---------------------------------------------------------------------------------- |
| `hanzo node peer invoke` | Replica-to-replica forward of one invocation to the pod holding the node's socket. |