Usage
One usage plane for every AI account you have — rate limits, credits, and spend, across Hanzo and the other providers you already pay for.
Hanzo Usage
Hanzo Usage is the universal AI connector and usage plane. Link your AI
provider accounts once, then see unified usage — rate limits, resets, credits,
and spend — everywhere Hanzo runs: the dev CLI, Hanzo Desktop, hanzo.app,
hanzo.chat, and console.hanzo.ai.
The story
- Connect once. Link Hanzo, the other AI providers you already pay for — the registry is extensible — plus GPU, cloud, and integration accounts (payments, ecommerce, marketing, analytics), using logins you already have. No passwords stored.
- See unified usage. One view across every account: limits, resets, credits, and spend, native in every Hanzo surface.
- Add your org. Optionally share verified logins org-wide and route AI usage through Hanzo's backend for a comprehensive view, analytics, and per-member reporting. A 1% fee applies to routed usage.
- Pay OSS AI devs. Hanzo is an AI-native cloud designed to route spend back to the open-source AI ecosystem it runs on.
How it works
The engine is @hanzo/usage — a headless TypeScript
core, MIT licensed. Each provider is a descriptor with an
ordered pipeline of fetch strategies (oauth → web → cli → apiToken →
localProbe) that reuse your existing logins — CLI OAuth token files, browser
sessions, API keys. Strategies fall back in priority order and never ask for
passwords. The same core drives the macOS menu-bar app, the CLI, the desktop
and web apps, and the console.
Quickstart
Install @hanzo/usage and read usage in ~15 lines
Console onboarding
Connect accounts at console.hanzo.ai → AI Accounts
Teams & orgs
Login sharing, verified routing, and per-member analytics
Quickstart
Console onboarding
Teams & orgs
Smart routing
How is this guide?