Link
The `hanzo link` commands.
Also for this capability: API · CLI · MCP · SDKs
The unified AI login manager's registry: the org+user-scoped record of WHICH provider accounts (Claude Max, ChatGPT Plus, a Hanzo API key, a raw provider key) a developer has signed into, ON WHICH MACHINES, with each account's latest usage snapshot.
hanzo link listEvery 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 link create | Registers a signed-in AI provider account on a machine. |
hanzo link list | Lists your linked accounts and the devices they sit on. |
hanzo link route | Gets the failover order across your linked accounts. |
devices
| Command | What it does |
|---|---|
hanzo link devices get <machine> | Shows one machine: its accounts, usage and live sessions. |
hanzo link devices revoke <machine> | Logs out every account on one machine and stops its sessions. |
get
| Command | What it does |
|---|---|
hanzo link get <id> | Reads one linked account. |
rm
| Command | What it does |
|---|---|
hanzo link rm <id> | Logs out one account and stops the sessions it was running. |
usage
| Command | What it does |
|---|---|
hanzo link usage accounts | Breaks down what the gateway routed through each of your accounts. |
hanzo link usage create | Reports usage samples from the device collector. |
hanzo link usage get | Shows one provider account's own usage dashboard. |
hanzo link usage summary | Shows plan consumption and Hanzo spend side by side. |
How is this guide?