# Usage

URL: https://docs.hanzo.ai/docs/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** 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 [platform.hanzo.ai](https://platform.hanzo.ai).

## The story

1. **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.
2. **See unified usage.** One view across every account: limits, resets,
   credits, and spend, native in every Hanzo surface.
3. **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.
4. **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`](https://docs.hanzo.ai/docs/usage/quickstart) — 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](https://docs.hanzo.ai/docs/usage/quickstart): Install @hanzo/usage and read usage in \~15 lines
- [Console onboarding](https://docs.hanzo.ai/docs/usage/console): Connect accounts at platform.hanzo.ai → AI Accounts
- [Teams & orgs](https://docs.hanzo.ai/docs/usage/teams): Login sharing, verified routing, and per-member analytics

- [Quickstart](https://docs.hanzo.ai/docs/usage/quickstart): Install @hanzo/usage and read unified AI usage in \~15 lines of TypeScript.
- [Console onboarding](https://docs.hanzo.ai/docs/usage/console): Connect your AI accounts at platform.hanzo.ai and read the unified usage dashboard.
- [Teams & orgs](https://docs.hanzo.ai/docs/usage/teams): Share verified logins org-wide, route AI usage through Hanzo, and get per-member analytics.
- [Smart routing](https://docs.hanzo.ai/docs/usage/routing): Send model "auto" to api.hanzo.ai and each prompt is routed to the model that fits the task and your SLO — for up to 90% lower AI spend.