Quosparr — Development skill for Claude Code

English · [简体中文](./README_ZH.md) · [繁體中文](./README_ZH_HANT.md) · [한국어](./README_KO.md) · [日本語](./README_JA.md) · [Русский](./README_RU.md) · [Français](./README_FR.md)

Quosparr

Named from Quota + Sparrow

A small sparrow perched in your menu bar, keeping watch over your Codex, Claude, and Grok quota.

Quosparr is a native menu bar / system tray app for macOS, Windows, and Linux. It shows Codex, Claude Code, and Grok subscription quota, reset credits, API-equivalent cost, and local sessions, with separate account management for each provider.

Highlights

**Codex**

• Remaining quota for the 5-hour, weekly, and additional windows, plus the current account, subscription tier, and expiration.
• Reset credit count, status, and expiration time.
• Weekly allowance estimate from the official weekly percent and daily Credits, compared with previous weeks to spot quota cuts.
• Codex Reset Updates: whether Codex rate limits have reset today, with its own refresh interval (data from Did Codex Reset).
• Provider accounts: browser sign-in, import local auth.json, paste token / JSON (including /auth/session), import files, or add an API key. Switching after confirmation atomically writes ~/.codex/auth.json.
• API accounts: a Base URL plus API key (empty Base URL means the official OpenAI API), with an optional model fetched from the site. Switching writes auth.json and the quosparr provider in config.toml (backed up first), and the balance of new-api-style or OpenAI-compatible relays shows in the account list, panel, status bar, floating window, and widget. A key login whose config.toml already selects a relay is picked up with that site and model. Editing the account in use can replace its key (empty keeps it) and asks whether to rewrite the config files now; restart Codex afterwards.
• Rec