# Usagi

> Self-hosted usage board for AI provider accounts

- **Year**: 2026
- **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.

## Tech stack

Built with React, Vite, and Hono. Runs self-hosted with Bun and SQLite, or as a Docker container. Credentials are encrypted at rest with AES when an encryption key is set.