AI coding tools leave useful token-count metadata in local session logs, but comparing day-to-day usage across providers usually means opening separate files or tools. otak-usage turns those logs into one status-bar readout: today or month-to-date, combined or per provider/model, with configurable alerts and optional metric export when you want dashboards.

Quick Start

1. Install from the VS Code Marketplace.
2. Use Claude Code or OpenAI Codex CLI normally on the machine where VS Code is running.
3. Check the right side of the VS Code status bar:

$18.01

Hover the status-bar item for a per-model breakdown of today and the current month. Click it to cycle between Today, This Month, and Limits (subscription rate-limit usage).

The hover tooltip puts Claude Code and Codex CLI side by side — each with its brand logo, rate-limit windows, per-model cost, and a provider total — followed by RTK token savings:

otak-usage — API-equivalent cost

OpenAI + Claude Total: $9.80 / $297.45

Claude Code — Limits (max)        │ Codex CLI — Limits (pro)
5h · 28% used · resets 16:39      │ 5h · 5% used · resets 18:59
7d · 13% used · resets 07-15      │ 7d · 21% used · resets 07-18
claude-opus-4-8:  $6.20 / $142.30 │ gpt-5.5:      $2.14 / $88.60
claude-sonnet-5:  $1.05 / $58.40  │ gpt-5.4-mini: $0.41 / $6.05
claude-haiku-4-5: $0.00 / $2.10   │
Total:            $7.25 / $202.80 │ Total:        $2.55 / $94.65

RTK — Token Savings
Period       Input    Output   Saved    Rate
Today        7.1M     2.9M     4.2M     59.5%
This Month   12.4M    5.1M     7.3M     58.9%
All Time     3.0B     110.1M   2.9B     96.4%

Period: This Month · Updated 16:09 · Click to switch view

Amounts above are illustrative. The status bar shows the combined total; the two provider columns, the limit windows, and the RTK table each appear only when that data is available and enabled.

Disclaimer: The amounts shown are API-equivalent estimates computed from local session logs and per-token API prices. If you use a subscription plan such as Claude Pro/Max or ChatGPT Plus/Pro, this is not what you actually pay; it is what the same usage would have cost through the API.

Capabilities

• Two providers, one glance: Claude Code (~/.claude/projects/**/*.jsonl) and OpenAI Codex CLI (~/.codex/sessions/**/rollout-*.jsonl) roll up into one status-bar total. Either provider can be used on its own.
• Per-model cost breakdowns: the tooltip and copied summary show token usage and API-equivalent USD by provider, model, and period. In the tooltip, Claude Code and Codex sit side by side (with their brand logos) and RTK savings follow below.
• Subscription rate limits: the tooltip shows how much of each provider's 5-hour and weekly rate-limit windows is used, with reset times and plan type — Codex from local session logs, Claude Code from the same Anthropic endpoint the CLI's /usage command uses. Optionally mirrored in the status bar.
• Stable model ordering: per-provider breakdowns list known models newest-first; unrecognized models appear last in name order.
• RTK token savings: when RTK (Rust Token Killer) is available, the tooltip adds Input / Output / Saved / Rate for Today, This Month, and All Time.
• Usage alerts: a VS Code notification appears when today's combined Claude + Codex estimate reaches your configured USD threshold, and/or when a subscription rate-limit window (5-hour or weekly) reaches your configured percentage. otakUsage.alertMode chooses which triggers fire (cost, limit, both, or off).
• Codex context optimization: on by default, this optimizes Codex's maximum context size to save tokens and ease subscription rate limits by pinning model_context_window and model_auto_compact_token_limit in your Codex config.toml (toggle otakUsage.optimizeCodexContext). Turning it off removes the two keys again; while it stays off, your Codex config is left untouched.
• OpenTelemetry telemetry: opt in to export aggregate token and cost metrics to any OTLP/HTTP endpoint, including a local OpenTelemetry Collector, Grafana Cloud, Honeycomb, or Datadog.
• Fast incremental scanning: current-month files are streamed, only newly appended bytes are scanned after the first pass, and scan state survives VS Code restarts.
• Remote-ready: the extension runs in the workspace extension host, so it reads logs where your CLIs run, including GitHub Codespaces, Dev Containers, and Remote-SSH hosts.
• Localized interface: commands, settings, notifications, and status messages follow your VS Code display language.

How It Works

On each refresh, otak-usage:

1. Resolves the Claude Code config directory and Codex home directory.
2. Streams current-month JSONL logs from the available providers.
3. Deduplicates transcript records and normalizes token counters.
4. Applies built-in pricing plus any otakUsage.pricingOverrides.
5. Reads the latest Codex rate-limit snapshot from the session logs and, when otakUsage.showRateLimits is enabled, fetches Claude Code limits from the Anthropic usage endpoint.
6. Updates the status bar, tooltip, and copied summary data.
7. Optionally reads RTK aggregate savings and exports OpenTelemetry metrics.

If a provider directory is missing, that provider is skipped without blocking the other one. Unknown-priced models are counted as usage but shown as n/a for cost until you add an override.

Commands

Settings

Subscription Rate Limits

Subscription plans (Claude Pro/Max, ChatGPT Plus/Pro) meter usage in a rolling 5-hour window and a weekly window. With otakUsage.showRateLimits enabled (the default), each provider section in the tooltip shows how much of both windows is currently used, when they reset, and the plan type — one row per window:

Limits (max)
5h · 5% used · resets 16:40
7d · 8% used · resets 07-15 14:00

• Codex CLI: read entirely locally. Rollout session logs already contain the server-reported rate_limits snapshot on every turn; the extension reads the tail of the most recent log. Because the snapshot dates from your last Codex activity, a window whose reset time has already passed is shown as 0% used rather than a stale value.
• Claude Code: local logs carry no rate-limit data, so the extension calls the Anthropic usage endpoint — the same source as the CLI's /usage command — authenticated with the OAuth token Claude Code stores in .credentials.json. The token is read-only: it is never refreshed, written, or sent anywhere except api.anthropic.com. If the credentials file is absent (for example on macOS, where Claude Code uses the Keychain) or the token has expired, Claude limits are simply omitted.

Set otakUsage.statusBarMode to surface limits in the status-bar item itself. Each provider is shown with its brand logo (Claude / OpenAI, shipped as an icon font) followed by its 5-hour window percentage, so both providers read on the same scale; a snapshot without 5-hour data falls back to its weekly window.

Subscription users get limits by default: on first run, when a rate-limit snapshot proves a subscription plan (Claude Pro/Max via the OAuth credentials, or a Codex plan_type), the status bar switches to the limits view once. This never overrides you — if statusBarMode is already set in any settings scope, or showRateLimits is off, the detection marks itself done and every later change is yours.

• cost (default): the API-equivalent cost, e.g. $18.01.
• limits: the per-provider percentages instead of cost, e.g. {claude} 5% {openai} 100% (falls back to cost until a snapshot is available).
• costAndLimits: both, e.g. $18.01 {claude} 5% {openai} 100%.

Clicking the status-bar item cycles the view: today's cost → this month's cost → limits → back to today's cost. Leaving the limits view restores your configured mode, so a costAndLimits preference survives the round trip.

Disabling otakUsage.showRateLimits hides everything, reverts the click to the classic Today/This Month toggle, and stops the network request.

Cost Model

• Claude Code: each assistant message records input, output, cache-read, and cache-write token counts. Cost is calculated from input, output, cache reads, 5-minute cache writes, and 1-hour cache writes. Fast-mode responses are tracked as <model>-fast and priced separately when a matching table entry exists.
• Codex CLI: each turn records last_token_usage. Cost is calculated from uncached input, cached input, and output tokens. Reasoning tokens are already included in output tokens. For GPT models with long-context pricing, the extension evaluates each turn independently and applies the published input/output multipliers when total input exceeds 272K tokens.
• Pricing lookup: built-in tables cover Claude Fable/Mythos/Opus/Sonnet/Haiku families plus GPT-5.x, Codex, o-series, and GPT-4.x models. Exact match is tried first, then longest-prefix match, so dated model IDs resolve to their base entry.
• Overrides: use otakUsage.pricingOverrides when a model is missing or a price changes. Unknown models count as $0 and appear as n/a per model until configured.

The built-in table records the date it was last checked against official pricing pages. Because provider pricing can change, treat the output as an estimate and configure overrides when exact reporting matters.

Telemetry

Telemetry is off by default. When otakUsage.telemetry.enabled is true, every refresh exports aggregate metrics as OTLP/JSON to the configured OTLP/HTTP endpoint. No OpenTelemetry SDK dependency is added; the extension posts plain OTLP/JSON.

Labels follow the OpenTelemetry GenAI semantic conventions.

Token counts and cost are month-to-date and reset at the start of each month. RTK counts are all-time. Resource attributes include service.name, service.version, and, when configured, service.instance.id.

Security & Privacy

otak-usage is local by default:

• Local log reading: it reads token-count metadata from local Claude Code and Codex CLI logs.
• No prompt collection: it does not collect, store, or export prompt content.
• Read-only credential use, provider-only: for the Claude rate-limit display it reads the OAuth token Claude Code already stores locally and sends it only to api.anthropic.com — never to any other endpoint, and never modified. Disable otakUsage.showRateLimits to prevent this entirely; no other feature touches credential files.
• No other network use: apart from the Anthropic rate-limit request above (on by default, one call per refresh interval), network access happens only when you explicitly enable OpenTelemetry export.
• User-controlled endpoints: telemetry goes only to the OTLP/HTTP endpoint and headers you configure.
• Local RTK integration: optional RTK support runs the local rtk gain command and reads only aggregate savings numbers.
• Open source, MIT-licensed: the full implementation is auditable on GitHub.

Language Support

The interface follows your VS Code display language:

English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Tiếng Việt · Español · Português (BR) · Français · Deutsch · हिन्दी · Bahasa Indonesia · Italiano · Русский · العربية · Türkçe

Requirements

• VS Code 1.90.0 or newer
• At least one of:
  • Claude Code with local session logs
  • OpenAI Codex CLI with local session logs
• Optional: RTK (Rust Token Killer) for token-savings summaries

Installation

Install from the VS Code Marketplace, or run:

ext install odangoo.otak-usage

npm install
npm run package
code --install-extension otak-usage-<version>.vsix

Troubleshooting

• The status bar does not show usage: confirm Claude Code or Codex CLI has created local session logs on the same machine or remote host where the VS Code extension host is running.
• One provider is missing: check otakUsage.claudeConfigDir or otakUsage.codexHome if your logs are outside the default locations.
• A model shows n/a cost: add an entry to otakUsage.pricingOverrides for that model.
• Rate limits are not showing: Codex limits appear after the first Codex turn on this machine (they come from session logs). Claude limits require ~/.claude/.credentials.json with a valid OAuth token — on macOS Claude Code keeps credentials in the Keychain, so Claude limits are unavailable there. Also confirm otakUsage.showRateLimits is enabled and reload the window after installing an update.
• RTK savings are absent: install rtk, put it on PATH, or set otakUsage.rtkPath.
• Telemetry is not appearing: confirm otakUsage.telemetry.enabled, the OTLP/HTTP base endpoint, custom headers, and the collector's /v1/metrics route.
• The numbers differ from a subscription bill: otak-usage estimates API-equivalent cost, not subscription spend.

Related Extensions

More VS Code extensions by odangoo:

License

Released under the MIT License.