# Usagi

> Self-hosted usage board for AI provider accounts

- **Year**: 2026
- **Platforms**: web
- **Tools**: [React](https://react.dev), [Hono](https://hono.dev), [SQLite](https://wastu.net/experiments/usagi/tools/sqlite), [Bun](https://bun.sh)
- **Links**: [GitHub](https://github.com/bgwastu/usagi)

I wasn't satisfied with any existing solution for tracking AI usage across providers.

Nothing could handle the mix of OAuth providers like Codex and Antigravity alongside cookie-based ones like Cursor and OpenCode Go. And none of them tracked non-AI providers like Tavily or Exa at all.

I wanted a single board where I could see every quota, every reset timer, and every usage bar across all my accounts at a glance. So I built Usagi.

It supports OAuth with auto-refresh tokens (Codex, Antigravity), session cookies (Cursor, OpenCode Go), and plain API keys (Tavily, Exa, Composio, Command Code). You add your accounts, and the board refreshes usage data automatically.

# Supported providers

- **Codex** — OAuth (PKCE) with auto-refresh tokens; tracks 5-hour and weekly usage windows.
- **Antigravity** — Google OAuth (desktop flow) with auto-refresh; tracks Gemini and Claude & Other quota families, expandable per model.
- **OpenCode Go** — Session cookie authentication; auto-discovers workspaces and monitors 5-hour, weekly, and monthly windows.
- **Cursor** — Session cookie authentication (`WorkosCursorSessionToken`); tracks Pro plan usage, Auto + Composer quotas, and API limits.
- **Command Code** — Studio API key (`user_…`); tracks monthly plan credits alongside 5-hour and weekly limits.
- **Tavily** — API key authentication; tracks Researcher/Plan credits and key allowances.
- **Exa** — Team Management service key; monitors 3d, 7d, and 30d spend windows plus key budgets.
- **Composio** — Org API key (`oak_…`); monitors monthly tool-call quotas, Pro tool calls, and session limits.

I'll continue adding more providers over time as my workflow evolves and new tools make their way into my day-to-day stack.

#### Why I used SQLite in Usagi

I like [SQLite](https://www.sqlite.org/) for Usagi because a local database file is enough for its settings and cached usage. I wanted people to self-host it without setting up a separate database service.