Linux Usage

GNOME top-bar quota monitor for Codex and Claude, with a native macOS menu bar port in macos/.

Build & install

bun install
bun run check        # typecheck + lint + build both bundles
make install-esm     # GNOME 45+
make install-legacy  # GNOME 40-44

Layout

• src/extension/ — extension source (TypeScript)
• src/helper/ — GJS helper, bundled in the zip
• macos/ — SwiftUI menu bar app (cd macos && make app)
• dist/, dist-pre45/ — generated bundles (ESM and legacy GJS)
• contracts/snapshot.schema.json — normalized snapshot schema

Adding a provider

1. Add metadata to src/extension/providers.json
2. Implement the module in src/helper/src/providers/
3. Register it in src/helper/src/registry.ts
4. Port it to macos/Sources/LinuxUsage/Providers/ and add it to ProviderCatalog.swift and Registry.swift

See AGENTS.md for the dual-package build pipeline and docs/ for architecture and provider notes.