Files

T

David Heinemeier HanssonandClaude Opus 5 39936d2982 Ship the model usage widget in the default bar

The widget hid itself well enough that nobody found it: it only ever
appeared if you knew the id and ran `omarchy bar plugin add`, since it was
in neither the shipped layout nor any migration.

Defaulting it on costs nothing on machines that don't use it. Panel.qml is
`visible: providers.length > 0`, and Main.qml only counts a provider that
is enabled and has actually recorded prompts, sessions, active days, or a
rate limit. A box that has never run Claude Code or Codex draws an empty
bar item, and the icon arrives on its own at the first scan that finds
usage — which is the behavior the widget already advertised.

The migration skips any config that already lists the widget in any
section, so a curated bar keeps its own placement rather than gaining a
second copy.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-07-29 14:49:55 -04:00

4.5 KiB

Raw Blame History

Model usage

One bar icon and one panel for every AI coding subscription on the machine. Panel.qml owns the bar button and the popup; Main.qml owns provider fan-out and the optional cross-device aggregation; providers/ holds one adapter per subscription.

Panel

Hero — the mark, the tool, and the plan it runs on ("Max 20x", "Pro"). Auth and endpoint problems replace the plan line and repeat in a card.
Subscription switch — one chip per enabled provider (h/l or click). It appears only when more than one provider is enabled.
Limits — a meter per window (session, weekly). The notch on the meter marks where an evenly paced window would have you right now, so the gap between the fill and the notch is the whole story: fill behind the notch means budget in reserve, fill past it means you are burning faster than the clock and the row says when it runs out.
Usage this week — one row per day for the last week: day, bar, tokens, with today bolded at the bottom. Hover today for its prompt and session count.
Usage by model — total tokens and active days in the header, then tokens per model with the bar behind each row scaled to the heaviest model, the same way the weekly chart scales to its busiest day. Hover for the input / output / cache split.

A subscription appears only when it is enabled in settings and has actually recorded usage — on this machine or on a synced one. With one such provider there is no switch row at all; with none, the module leaves the bar entirely rather than sitting there with nothing to say. A CLI installed mid-session shows up at the next refresh, so nothing polls the disk waiting for it.

That self-hiding is why the widget ships in the default bar layout: a machine that has never run Claude Code or Codex draws nothing, and the icon arrives on its own the first time a scan finds usage. Drop it with omarchy bar plugin remove omarchy.model-usage.

Providers

Provider	Limits	Local stats
`claude`	Anthropic's OAuth usage endpoint (5-hour session + 7-day weekly)	`~/.claude/projects` scanned by `scripts/claude_usage_scanner.py`, plus `stats-cache.json` and `history.jsonl`
`codex`	`scripts/codex_usage_scanner.py` reading the Codex CLI state	the same scanner

Claude limits need a signed-in CLI; without credentials the panel says so and falls back to local stats only.

Interactions

Bar icon: left = panel, right = refresh, middle = next subscription.
Panel: h/l switch subscription, j/k scroll, r or Enter refresh, Tab moves to the neighboring bar panel, Esc closes.
IPC: omarchy-shell omarchy.model-usage <open|close|toggle|refresh|next>.

Settings

Settings live in the widget's entry in ~/.config/omarchy/shell.json. The top-level keys can be set with omarchy bar plugin set omarchy.model-usage <key> <value>:

Key	Default	What it does
`refreshIntervalSec`	`900`	How often local scans and snapshots refresh
`syncMode`	`"Off"`	`"On"` writes this machine's snapshot and merges the others
`syncDir`	`""`	A folder synced by Syncthing, Dropbox, rsync, …
`syncFileName`	`<hostname>.json`	This machine's snapshot file
`syncDeviceId`	hostname	Stable device name inside the snapshot

Numbers need --json, or they land in shell.json as strings:

omarchy bar plugin set omarchy.model-usage refreshIntervalSec 300 --json
omarchy bar plugin set omarchy.model-usage syncDir '~/Sync/model-usage'

Per-provider settings are nested, and set writes its key literally rather than walking a dotted path — so pass the whole providers object as JSON (or edit shell.json directly):

omarchy bar plugin set omarchy.model-usage providers '{
  "claude": {
    "enabled": true,
    "statsPath": "~/.claude/stats-cache.json",
    "credentialsPath": "~/.claude/.credentials.json",
    "projectsPath": "~/.claude/projects"
  },
  "codex": { "enabled": false }
}' --json

enabled defaults to true for both; set it to false to hide a subscription that is installed. The paths above are the defaults.

With syncMode on, every *.json snapshot in syncDir is merged, so today, the last 7 days, and the all-time totals cover every machine you code on — active days are unioned by date rather than summed. Rate limits stay per-account and are never merged.

One caveat on "all-time": the Codex scanner only reads native session files touched in the last 30 days, so Codex totals and its day count cover that window. Claude's cover every transcript still on disk.

4.5 KiB Raw Blame History