mysubs

Check how much of your AI subscriptions you have used, across accounts and providers, in one place.

Usage

mysubs            # show usage for all accounts
mysubs codex      # show only codex accounts
mysubs codex:work # show only the "work" codex account
mysubs codex:     # show only automatically detected codex accounts
mysubs codex claude opencode:zen # select multiple providers or accounts
mysubs -j         # print results as JSON
mysubs -f         # ignore the cache and fetch fresh data

Install

npm install -g mysubs

Configuration

Create ~/.config/mysubs/config.json. Accounts that already exist on your machine (like Codex or Claude logins) are detected automatically, so you may not need a config file at all.

Example:

{
  "$schema": "https://github.com/NazmusSayad/mysubs/raw/refs/heads/schema/schema.json",
  "contrast": 0.4,
  "nerdFont": true,
  "maxWidth": 120,
  "codex": {
    "accounts": {
      "work": { "name": "Work", "configDir": "~/.config/codex" }
    }
  },
  "claude": {
    "accounts": {
      "personal": { "configDir": "~/.claude" }
    }
  },
  "openrouter": {
    "accounts": {
      "main": { "apiKey": "env:OPENROUTER_API_KEY" }
    }
  },
  "opencode": {
    "accounts": {
      "go": { "product": "go", "apiKey": "env:OPENCODE_API_KEY" },
      "zen": { "product": "zen", "cookie": "key:opencode-zen" }
    }
  },
  "copilot": {
    "accounts": {
      "cli": { "source": "gh" },
      "work": { "source": "token", "token": "key:copilot-work" }
    }
  }
}

Account keys select the account, such as mysubs codex:work; name is an optional display name. info overrides the account info reported by the provider (the name shown after ›); set it to a string to replace it, or to false to hide it. Set detect inside an individual provider to false to skip automatic account detection for that provider. The root detect setting still disables detection for every provider.

Secrets

Never put a raw API key in the config. Reference it instead, and mysubs will resolve it at run time:

• env:NAME — read from an environment variable
• key:NAME — read from your OS keyring, stored with mysubs key set NAME

mysubs key set openrouter   # prompts for the secret, stores it in the keyring
mysubs key get openrouter   # prints the stored secret

OpenCode Go uses an API key. Zen usage requires an authenticated Cookie header from opencode.ai; optionally set workspaceID to select a specific workspace.

Antigravity

Antigravity reports two shared quota pools, each with a rolling 5-hour and a weekly window. Gemini Flash and Pro share session and weekly; Claude and GPT-OSS share a second pool, shown as other and other weekly.

Usage comes from the Antigravity CLI itself, so no token or sign-in is needed beyond running antigravity once. If the CLI is already running, mysubs asks it directly; otherwise it starts one in the background, reads the quota, and stops it again. Set cliPath on the account or ANTIGRAVITY_CLI_PATH when the antigravity (or agy) binary is not on your PATH.

Because a cold read starts the CLI, it takes a few seconds; the cache keeps later runs instant. This is a Google-internal interface and may change.

GitHub Copilot

Copilot reads a GitHub token. Detection uses GITHUB_TOKEN, then GH_TOKEN, and falls back to gh auth token when the GitHub CLI is installed and signed in, so gh auth login is usually all the setup you need.

To configure it explicitly, set source on the account:

• "source": "gh" — run gh auth token at fetch time
• "source": "token" — resolve token from an env var or the keyring

Paid plans meter AI credits, shown as credits. Chat and completions are unlimited there and stay hidden; on the free plan they show instead. Org-managed Business/Enterprise seats report no per-seat quota, so only the plan is shown.