oc-usage

CLI tool to monitor AI platform usage quotas with a pretty terminal UI.

Features

• Antigravity (Google Cloud Code/IDX) usage monitoring
• GitHub Copilot usage monitoring
• Claude (Anthropic) usage monitoring
• Pretty terminal UI with box drawing
• Watch mode with auto-refresh
• JSON output for scripting

Installation

# Using npx (no install)
npx @yuuzu/oc-usage

# Using bunx
bunx @yuuzu/oc-usage

# Global install
npm install -g @yuuzu/oc-usage

Usage

# Show all providers
oc-usage

# Show specific provider
oc-usage ag          # Antigravity
oc-usage cp          # GitHub Copilot
oc-usage cl          # Claude

# Watch mode (auto-refresh every 30s)
oc-usage -w
oc-usage ag -w -i 60  # Custom interval (60s)

# JSON output
oc-usage -j
oc-usage cl -j

Authentication

Antigravity

Reads credentials from ~/.config/opencode/antigravity-accounts.json (managed by OpenCode/IDX).

GitHub Copilot

# Authenticate with GitHub
oc-usage cp auth

This uses GitHub Device Code flow to authenticate.

Claude

Reads OAuth token from ~/.claude/.credentials.json (managed by Claude CLI).

Alternatively, set the ANTHROPIC_API_KEY environment variable.

Screenshot

╭───────────────────────────────────────────────────────────────╮
│  AI Usage Monitor                                             │
╰───────────────────────────────────────────────────────────────╯
╭── Antigravity ────────────────────────────────────────────────╮
│ Account: [email protected]                                     │
│                                                               │
│ gemini-3-pro   ████████████████     100.0%  22m               │
│ gemini         ████████████░░░░      75.0%  5h 1m             │
│ claude         ██████░░░░░░░░░░      40.0%  4h 44m            │
╰───────────────────────────────────────────────────────────────╯
╭── GitHub Copilot ─────────────────────────────────────────────╮
│ Plan: individual                                              │
│                                                               │
│ Premium        ███████████████░      94.1%  16 days           │
│ Chat           ████████████████  unlimited                    │
│ Completions    ████████████████  unlimited                    │
╰───────────────────────────────────────────────────────────────╯
╭── Claude ─────────────────────────────────────────────────────╮
│                                                               │
│ Weekly         ██████████░░░░░░      63.0%  3 days            │
│ Daily          ████████████░░░░      76.0%  3h                │
╰───────────────────────────────────────────────────────────────╯

License

MIT