How jimakosk46/quota-usage works
quota-usage is a macOS CLI for viewing Codex and Claude subscription quota windows across discovered and registered accounts. Its main workflow inventories accounts, selects them, collects live provider data or reads cached results, then presents a dashboard or snapshot in human or JSON form. Separate capabilities handle account setup, diagnostics, uninstall, and checkout self-updates. The graph follows the documented product flow and sampled collection wiring; some CLI dispatch and account-management internals are not shown in the excerpts, so those links rely on README statements or are omitted.
Main entry points: collect.ts Collection orchestrator · cli.ts Usage CLI · accounts.ts Account management · tui.ts Dashboard
Components 27
CLI and output
- Usage CLI
src/cli.ts - Dashboard
src/tui.ts - Human output
src/render-human.ts - JSON output
src/render-json.ts
Account lifecycle
- Config store
src/config.ts - Account management
src/accounts.ts - Account discovery
src/discovery.ts - Diagnostics
src/doctor.ts - Uninstall
src/uninstall.ts
Quota collection
- Collection orchestrator
src/collect.ts - Account selection
src/selectors.ts - Codex adapter
src/providers/codex.ts - Claude live adapter
src/providers/claude-live.ts - Claude cache helper
src/providers/claude-cache.ts - Usage cache
src/cache.ts - Status-line collector
src/statusline-helper.ts
Runtime support
- Update trigger
src/auto-update.ts - Checkout updater
src/update-checkout.ts - Process manager
src/processes.ts - Path safeguards
src/paths.ts - Executable resolver
src/executable.ts - Duration utilities
src/duration.ts - Error model
src/errors.ts - Domain types
src/types.ts
Other components
- User
- Codex / Claude CLIs
- Git origin
Connections 32
- User → Usage CLI: runs commands
README.md - Usage CLI → Collection orchestrator: starts collection
README.md - Usage CLI → Account management: manages accounts
README.md - Usage CLI → Diagnostics: runs diagnostics
README.md - Usage CLI → Uninstall: uninstalls tool
README.md - Usage CLI → Dashboard: opens dashboard
README.md - Usage CLI → Human output: prints snapshot
README.md - Usage CLI → JSON output: prints JSON
README.md - Usage CLI → Update trigger: starts update
README.md - Dashboard → Collection orchestrator: refreshes data
src/tui.ts - Dashboard → Human output: renders view
src/tui.ts - Collection orchestrator → Account discovery: discovers accounts
src/collect.ts - Collection orchestrator → Account selection: selects accounts
src/collect.ts - Collection orchestrator → Codex adapter: collects Codex
src/collect.ts - Collection orchestrator → Claude live adapter: collects Claude
src/collect.ts - Collection orchestrator → Usage cache: reads and writes
src/collect.ts - Collection orchestrator → Config store: uses settings
src/collect.ts - Codex adapter → Codex / Claude CLIs: queries Codex
README.md - Claude live adapter → Codex / Claude CLIs: queries Claude
README.md - Account management → Config store: saves registrations
README.md - Account management → Codex / Claude CLIs: launches login
README.md - Account management → Status-line collector: installs collector
README.md - Update trigger → Checkout updater: requests update
src/auto-update.ts - Checkout updater → Git origin: fast-forwards from
README.md - Collection orchestrator → Executable resolver: resolves providers
src/collect.ts - Collection orchestrator → Process manager: tracks subprocesses
src/collect.ts - Account management → Path safeguards: checks managed paths
src/accounts.ts - Config store → Path safeguards: uses app paths
src/config.ts - Collection orchestrator → Duration utilities: parses cache age
src/collect.ts - Collection orchestrator → Error model: normalizes failures
src/collect.ts - Collection orchestrator → Domain types: produces results
src/collect.ts - Claude cache helper → Usage cache: supports cache flow