# Leaderboard

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

> The `hanzo leaderboard` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/leaderboard) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/leaderboard) · [SDKs](https://docs.hanzo.ai/docs/sdks)

The ranking of who uses AI most, in your org and globally.

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

```bash
hanzo leaderboard get
```

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 leaderboard activity` | Returns the per-day usage series for ONE authorized subject — the points a contribution heatmap and a timeline are drawn from, gap-filled so every day in the range is present.                        |
| `hanzo leaderboard get`      | Ranks AI usage over a window, either the users of the caller's own org or organizations against each other, and always reports the caller's own standing even when it falls outside the returned page. |

### Opt-in

| Command                           | What it does                                                                                                    |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `hanzo leaderboard optin get`     | Returns the caller's own public-listing preference and their org's, each with whether the caller may change it. |
| `hanzo leaderboard optin org`     | Sets the ORG's listing on the cross-org global board.                                                           |
| `hanzo leaderboard optin replace` | Sets the CALLER's own public-listing preference on the leaderboard.                                             |