← All guides

Pair with the dashboard (CLI)

Link a halo CLI wallet — operator or consumer — to a Halo dashboard account to monitor your stats on the web and join the League. Here's the pairing flow.

Running the halo CLI headless? Pair it with a Halo dashboard account to monitor your operator and spending on the web and appear on the League. Pairing works for an operator wallet, a consumer wallet, or both.

Halo is in alpha on Base mainnet with real USDC.

Get a pairing code

On the machine running the CLI, generate a code:

halo link

It prints a 9-digit code in the form XXX-XXX-XXX, valid for 5 minutes. (Operators can also get one automatically by adding --with-pairing to halo setup.)

Confirm it in the app

  1. Open the Halo app and connect your dashboard wallet — this is separate from your operator wallet, and can be any wallet you want to monitor from.
  2. Go to Profile → Link a wallet, paste the code into the Pairing code (XXX-XXX-XXX) field, and click Confirm link.
  3. Approve the signature. Done — the CLI wallet is now tied to your dashboard.

One dashboard wallet can claim many CLI wallets, so you can watch all your operators and your consumer wallet from a single account.

What you can see once linked

Profile → My operators (serving):

  • Headline: USDC earned, requests served, tokens served, season points, operators online/linked.
  • Per-node table: address, tier, points, requests, USDC earned, uptime.
  • Charts: a daily earnings & requests sparkline and a per-model breakdown.

Profile → My consumption (spending):

  • USDC spent, paid requests, tokens, consume points, and tier.

Your Dashboard also shows a season-points pill (split into serve · consume), tier badges, a streak, and the season countdown. From the CLI, halo status shows your wallet, provider, requests, and USDC earned/spent.

The League

The League is a seasonal points leaderboard with two boards — Operators (serving) and Users (consuming) — ranked by points, with columns for rank, tier, points, requests, tokens, and USDC. Tiers run bronze → silver → gold → platinum → diamond and reset each season.

Points accrue automatically from real activity — you don’t opt in; pairing just tags you as you on the board and unlocks your stats. Note that routing your own served models through your own consumer endpoint earns no points.