bot/docs/cli/devices.md

summary, read_when, title

summary	read_when	title
CLI reference for `hanzo-bot devices` (device pairing + token rotation/revocation)	You are approving device pairing requests You need to rotate or revoke device tokens	devices

hanzo-bot devices

Manage device pairing requests and device-scoped tokens.

Commands

hanzo-bot devices list

List pending pairing requests and paired devices.

hanzo-bot devices list
hanzo-bot devices list --json

hanzo-bot devices approve <requestId>

Approve a pending device pairing request.

hanzo-bot devices approve <requestId>

hanzo-bot devices reject <requestId>

Reject a pending device pairing request.

hanzo-bot devices reject <requestId>

hanzo-bot devices rotate --device <id> --role <role> [--scope <scope...>]

Rotate a device token for a specific role (optionally updating scopes).

hanzo-bot devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

hanzo-bot devices revoke --device <id> --role <role>

Revoke a device token for a specific role.

hanzo-bot devices revoke --device <deviceId> --role node

Common options

• --url <url>: Gateway WebSocket URL (defaults to gateway.remote.url when configured).
• --token <token>: Gateway token (if required).
• --password <password>: Gateway password (password auth).
• --timeout <ms>: RPC timeout.
• --json: JSON output (recommended for scripting).

Note: when you set --url, the CLI does not fall back to config or environment credentials. Pass --token or --password explicitly. Missing explicit credentials is an error.

Notes

• Token rotation returns a new token (sensitive). Treat it like a secret.
• These commands require operator.pairing (or operator.admin) scope.