# Bot

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

> The `hanzo bot` commands.

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

A bot doing your work on a real desktop, live, while you watch.

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

Coming from OpenClaw? One command moves your install to Hanzo Bot. [Migrate from OpenClaw →](https://docs.hanzo.bot/docs/install/migrate-from-openclaw)

```bash
hanzo bot runs 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.

### Members

| Command                  | What it does                                                                                                                            |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo bot members get`  | Returns the caller org's bots as space members — each with the member account uuid and the Person reference the roster addresses it by. |
| `hanzo bot members sync` | Re-projects the caller org's bots as members into every space of the org and removes the ones whose agent is gone.                      |

### Runs

| Command                       | What it does                                                                                                                                             |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo bot runs list`         | Returns the caller org's live bot runs, read from the bot runtime and projected into the console contract with each run's live session URL derived here. |
| `hanzo bot runs stop <runId>` | Terminates one of the caller org's own bot runs and reports its terminal state.                                                                          |