coding-usage-bar 0.5.0 → 0.5.1

package/README.md

@@ -35,6 +35,12 @@ coding-usage-bar status
 
 ## Troubleshooting
 
+**Menu bar icon showing on your external display but not on the laptop?**
+
+That is a width problem, not a bug. macOS does not clip a menu bar item that is too wide -- it pushes it left, under the notch and into the app menu area, where it is simply gone. A notched 13" leaves 645pt to the right of the notch for *every* menu bar icon on the machine, and the full six-provider title alone is 511pt.
+
+Coding Usage Bar measures that space and picks a title width to fit (see [Menu Bar](#menu-bar)). Open the dropdown and read the `Title` row: its tooltip tells you how much space was measured and which width was chosen. Click the row to override.
+
 **Menu bar icon not showing after install?**
 
 1. Run `coding-usage-bar doctor --fix`. It relaunches SwiftBar, reinstalls the menu bar plugin if missing, re-adds SwiftBar to login items, and collects status data.
@@ -55,6 +61,7 @@ coding-usage-bar status
 | `coding-usage-bar status --json` | Print the same status snapshot written to `~/.coding-usage-bar/status.json` |
 | `coding-usage-bar status --refresh` | Re-collect local usage before printing status |
 | `coding-usage-bar menubar render` | Print SwiftBar-compatible menu text from `~/.coding-usage-bar/status.json` |
+| `coding-usage-bar menubar cycle-title-mode` | Cycle the menu bar title width: `auto` → `full` → `single` → `icon` |
 | `coding-usage-bar menubar install` | Install the SwiftBar plugin wrapper |
 | `coding-usage-bar menubar uninstall` | Remove the Coding Usage Bar managed SwiftBar plugin |
 | `coding-usage-bar ingest claude-statusline` | Read Claude Code status line JSON from stdin and cache usage |
@@ -193,6 +200,22 @@ The compact menu bar title and dropdown use recognizable Provider marks for Code
 {Codex icon} 5H:14%,7D:67% │ {Claude icon} 5H:24%,7D:74% │ {GLM icon} 5H:36%,7D:7%
 ```
 
+### Title width
+
+The menu bar is the scarcest space on the machine, and macOS gives no way to ask whether an item will fit. So the producer measures what is available and the title picks a width that survives it:
+
+| Tier | Width | Shows |
+|------|-------|-------|
+| `full` | ~511pt | Every provider with its own mark and bars |
+| `single` | ~68pt | Only the provider closest to trouble |
+| `icon` | ~35pt | A state-colored flame; the full title moves to the tooltip |
+
+`auto` is the default and picks a tier from the measured budget: a full-width menu bar gets `full`, a notched display gets `single`, and anything narrower falls to `icon`. The dropdown card is identical in every tier -- narrowing the title never costs you data, only a glance.
+
+The measurement runs in the daemon, never in the render path, so switching displays takes up to one collection cycle (300s) to follow. Click the `Title` row in the dropdown to cycle `auto` → `full` → `single` → `icon` and pin a width immediately.
+
+Whatever fails -- no measurement, a missing asset, a PNG error -- the title falls back to the flame icon. It never renders as nothing, because an invisible menu bar item is indistinguishable from a broken tool.
+
 SwiftBar only supports one bitmap image on a single stable title item, so Coding Usage Bar renders the full title into one transparent PNG at render time. That bitmap keeps each provider marker next to its own usage segment while avoiding SwiftBar's multi-title rotation behavior. The dropdown stays read-only and uses SwiftBar-native symbols, badges, progress meters, reset time, target range, data age, and warnings. SwiftBar is a host dependency; `coding-usage-bar uninstall` removes the Coding Usage Bar plugin but does not uninstall SwiftBar itself.
 
 ## Runtime Files
@@ -201,7 +224,8 @@ SwiftBar only supports one bitmap image on a single stable title item, so Coding
 |------|---------|
 | `~/.coding-usage-bar/app/` | Stable runtime copy used by launchd, Claude ingest hints, and SwiftBar |
 | `~/.coding-usage-bar/config.json` | Provider selection, default `["codex", "claude", "glm", "deepseek", "minimax", "kimi"]` |
-| `~/.coding-usage-bar/status.json` | Stable display-layer entry point |
+| `~/.coding-usage-bar/status.json` | Stable display-layer entry point, including the measured menu bar budget |
+| `~/.coding-usage-bar/compact-mode` | Manual menu bar title width override; absent means `auto` |
 | `~/.coding-usage-bar/codex/latest.json` | Latest normalized Codex usage |
 | `~/.coding-usage-bar/claude/latest.json` | Latest normalized Claude usage after status line ingest |
 | `~/.coding-usage-bar/glm/latest.json` | Latest normalized GLM usage from Zhipu AI quota API |

package/dist/cli.js

@@ -6,7 +6,7 @@ import { formatStatusRows, formatAnalysisDetail, formatIssues, formatProviderMet
 import { loadDisplayStatusSnapshot, collectStatusSnapshot } from "./runtime.js";
 import { runDaemonOnce } from "./daemon.js";
 import { doctorHasFailures, formatDoctor, runDoctor, runDoctorFix } from "./doctor.js";
-import { installMenuBar, renderMenuBar, uninstallMenuBar, toggleCompactMode } from "./menubar.js";
+import { installMenuBar, renderMenuBar, uninstallMenuBar, cycleTitleMode } from "./menubar.js";
 import { buildPaths } from "./paths.js";
 import { bakeGlyphAtlases } from "./glyphs.js";
 import { maybePromptForStar } from "./star.js";
@@ -25,7 +25,7 @@ Usage:
   coding-usage-bar menubar render
   coding-usage-bar menubar install [--dry-run]
   coding-usage-bar menubar uninstall [--dry-run]
-  coding-usage-bar menubar toggle-compact
+  coding-usage-bar menubar cycle-title-mode
   coding-usage-bar menubar bake-glyphs [--dry-run]
   coding-usage-bar ingest claude-statusline
   coding-usage-bar daemon [--once] [--dry-run]
@@ -118,9 +118,11 @@ async function main() {
             console.log(uninstallMenuBar({ dryRun }).join("\n"));
             return;
         }
-        if (command === "menubar" && subcommand === "toggle-compact") {
-            const isCompact = toggleCompactMode();
-            console.log(isCompact ? "Compact" : "Expanded");
+        // `toggle-compact` is the pre-tier name for this action. A dropdown that
+        // SwiftBar rendered before the upgrade still carries it, so a click on
+        // that stale menu must keep working instead of erroring out.
+        if (command === "menubar" && (subcommand === "cycle-title-mode" || subcommand === "toggle-compact")) {
+            console.log(cycleTitleMode());
             return;
         }
         if (command === "menubar" && subcommand === "bake-glyphs") {

package/dist/codex.d.ts

@@ -3,4 +3,6 @@ export declare function usageFromCodexRateLimits(rateLimits: unknown, options: {
     observedAt?: string;
     source: string;
 }): ProviderUsage | null;
-export declare function collectCodexUsage(codexHome?: string): ProviderUsage;
+export declare function collectCodexUsage(codexHome?: string, options?: {
+    tailChunkBytes?: number;
+}): ProviderUsage;

package/dist/codex.js

@@ -72,34 +72,71 @@ export function usageFromCodexRateLimits(rateLimits, options) {
         windows,
     };
 }
-function latestCandidateFromFile(file) {
+const DEFAULT_TAIL_CHUNK_BYTES = 1024 * 1024;
+function candidateFromLine(line, file, fallbackMs) {
+    if (!line || !line.includes("rate_limits")) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(line);
+        const payload = parsed.payload;
+        const rateLimits = payload?.rate_limits ?? parsed.rate_limits;
+        const observedMs = parseObservedMs(parsed.timestamp ?? parsed.ts, fallbackMs);
+        const usage = usageFromCodexRateLimits(rateLimits, {
+            source: file,
+            observedAt: new Date(observedMs).toISOString(),
+        });
+        return usage ? { usage, observedMs } : null;
+    }
+    catch {
+        return null;
+    }
+}
+// Session rollouts of a long-lived Codex session can exceed V8's max string
+// length (~512 MiB); readFileSync(file, "utf8") then throws and the newest
+// usage silently disappears. Read the file backwards in bounded chunks and stop
+// at the first complete line that carries rate_limits.
+function latestCandidateFromFile(file, chunkBytes) {
     const stat = fs.statSync(file);
-    const lines = fs.readFileSync(file, "utf8").split(/\r?\n/);
-    for (let i = lines.length - 1; i >= 0; i -= 1) {
-        const line = lines[i]?.trim();
-        if (!line || !line.includes("rate_limits")) {
-            continue;
-        }
-        try {
-            const parsed = JSON.parse(line);
-            const payload = parsed.payload;
-            const rateLimits = payload?.rate_limits ?? parsed.rate_limits;
-            const observedMs = parseObservedMs(parsed.timestamp ?? parsed.ts, stat.mtimeMs);
-            const usage = usageFromCodexRateLimits(rateLimits, {
-                source: file,
-                observedAt: new Date(observedMs).toISOString(),
-            });
-            if (usage) {
-                return { usage, observedMs };
+    const fd = fs.openSync(file, "r");
+    try {
+        let position = stat.size;
+        let carry = Buffer.alloc(0);
+        while (position > 0) {
+            const readSize = Math.min(chunkBytes, position);
+            position -= readSize;
+            const chunk = Buffer.alloc(readSize);
+            fs.readSync(fd, chunk, 0, readSize, position);
+            const combined = carry.length > 0 ? Buffer.concat([chunk, carry]) : chunk;
+            let lineStart = 0;
+            if (position > 0) {
+                const newline = combined.indexOf(0x0a);
+                if (newline === -1) {
+                    carry = combined;
+                    continue;
+                }
+                carry = combined.subarray(0, newline);
+                lineStart = newline + 1;
+            }
+            else {
+                carry = Buffer.alloc(0);
+            }
+            const lines = combined.subarray(lineStart).toString("utf8").split(/\r?\n/);
+            for (let i = lines.length - 1; i >= 0; i -= 1) {
+                const candidate = candidateFromLine(lines[i]?.trim() ?? "", file, stat.mtimeMs);
+                if (candidate) {
+                    return candidate;
+                }
             }
         }
-        catch {
-            continue;
-        }
+    }
+    finally {
+        fs.closeSync(fd);
     }
     return null;
 }
-export function collectCodexUsage(codexHome = path.join(process.env.HOME ?? "", ".codex")) {
+export function collectCodexUsage(codexHome = path.join(process.env.HOME ?? "", ".codex"), options = {}) {
+    const chunkBytes = options.tailChunkBytes ?? DEFAULT_TAIL_CHUNK_BYTES;
     if (!isDir(codexHome)) {
         throw new Error(`Codex usage unavailable: ${codexHome} does not exist`);
     }
@@ -112,7 +149,7 @@ export function collectCodexUsage(codexHome = path.join(process.env.HOME ?? "",
             break;
         }
         try {
-            const candidate = latestCandidateFromFile(file);
+            const candidate = latestCandidateFromFile(file, chunkBytes);
             if (candidate && (!latest || candidate.observedMs > latest.observedMs)) {
                 latest = candidate;
             }

package/dist/display-probe.d.ts

@@ -0,0 +1,7 @@
+import { DisplayGeometry } from "./types.js";
+export interface DisplayProbeReading {
+    screenWidthPt: number;
+    auxiliaryTopRightPt: number;
+}
+export declare function geometryFromReading(reading: DisplayProbeReading, measuredAt: Date): DisplayGeometry | null;
+export declare function probeDisplayGeometry(measuredAt?: Date): DisplayGeometry | null;

package/dist/display-probe.js

@@ -0,0 +1,71 @@
+import { execFileSync } from "node:child_process";
+// The frontmost app's menus own the left half of the menu bar and their width
+// swings with whatever is focused (Chrome ~580pt, Finder ~200pt). Measuring it
+// for real means an Accessibility-permission AX sweep that costs 4.8s, so we
+// reserve a conservative constant instead. Erring high only demotes the title
+// one tier; erring low overflows the bar and macOS hides the item outright.
+const APP_MENU_RESERVE_PT = 600;
+const PROBE_TIMEOUT_MS = 5_000;
+// AppKit lives in the producer, never in the render path: spawning an
+// AppKit-linked process talks to the WindowServer and stalls the display.
+// The daemon runs this once every 300s, so the ~200ms is free there.
+const PROBE_SCRIPT = `ObjC.import('AppKit');
+// screens[0] is the menu bar display. NSScreen.mainScreen follows the key
+// window instead and would report the wrong screen in a multi-display setup.
+var screen = $.NSScreen.screens.objectAtIndex(0);
+var frame = screen.frame;
+var width = frame.size.width;
+var right = 0;
+try {
+  var area = screen.auxiliaryTopRightArea;
+  if (area && area.size) {
+    right = area.size.width;
+  }
+} catch (error) {
+  right = 0;
+}
+JSON.stringify({ screenWidthPt: width, auxiliaryTopRightPt: right });`;
+function isPositiveFinite(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+// Split out from the spawn so the budget policy is testable without a screen.
+export function geometryFromReading(reading, measuredAt) {
+    if (!isPositiveFinite(reading.screenWidthPt)) {
+        return null;
+    }
+    const screenWidthPt = Math.round(reading.screenWidthPt);
+    const auxiliary = reading.auxiliaryTopRightPt;
+    // A notch splits the bar into two auxiliary areas, so the right-hand one is
+    // strictly narrower than the screen. Without a notch macOS may report either
+    // a zero rect or the full frame; both mean "no notch, whole bar available".
+    const hasNotch = isPositiveFinite(auxiliary) && auxiliary < screenWidthPt - 1;
+    const extrasBudgetPt = hasNotch
+        ? Math.round(auxiliary)
+        : Math.max(0, screenWidthPt - APP_MENU_RESERVE_PT);
+    return {
+        screenWidthPt,
+        hasNotch,
+        extrasBudgetPt,
+        measuredAt: measuredAt.toISOString(),
+    };
+}
+export function probeDisplayGeometry(measuredAt = new Date()) {
+    if (process.platform !== "darwin") {
+        return null;
+    }
+    try {
+        const output = execFileSync("osascript", ["-l", "JavaScript", "-e", PROBE_SCRIPT], {
+            encoding: "utf8",
+            timeout: PROBE_TIMEOUT_MS,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const parsed = JSON.parse(output.trim());
+        return geometryFromReading(parsed, measuredAt);
+    }
+    catch {
+        // Headless launchd contexts, a locked screen, or a future AppKit change
+        // all land here. A missing measurement degrades the title tier; it must
+        // never take the usage collection down with it.
+        return null;
+    }
+}

package/dist/glm.js

@@ -30,15 +30,11 @@ function resetTimeIso(value) {
 // usage (same proto-style field omission as Kimi's zero `used`). The zero
 // percentage is a real signal and must not be dropped; a missing reset time
 // falls back to `observedAt`, which renders as "reset due".
-function pickTokenWindows(limits) {
-    const tokenLimits = limits.filter((limit) => limit.type === "TOKENS_LIMIT");
-    if (tokenLimits.length < 2) {
-        return null;
-    }
-    let five = tokenLimits.find((limit) => limit.unit === 3 && limit.number === 5) ?? null;
-    let seven = tokenLimits.find((limit) => limit.unit === 6 && limit.number === 1) ?? null;
+function pickTokenWindowsOfType(limits) {
+    let five = limits.find((limit) => limit.unit === 3 && limit.number === 5) ?? null;
+    let seven = limits.find((limit) => limit.unit === 6 && limit.number === 1) ?? null;
     if (!five || !seven) {
-        const rest = tokenLimits
+        const rest = limits
             .filter((limit) => limit !== five && limit !== seven)
             .sort((a, b) => (a.nextResetTime ?? 0) - (b.nextResetTime ?? 0));
         five = five ?? rest.shift() ?? null;
@@ -46,6 +42,19 @@ function pickTokenWindows(limits) {
     }
     return five && seven ? { five, seven } : null;
 }
+function pickTokenWindows(limits) {
+    // Zhipu migrated Coding Plan quota reporting from TOKENS_LIMIT (token
+    // counts) to CREDIT_LIMIT (credit counts, observed live 2026-08-29) with the
+    // same unit/number window shapes. Prefer the token signal when both exist;
+    // fall back to credits so credit-based plans are not dropped as unusable.
+    for (const type of ["TOKENS_LIMIT", "CREDIT_LIMIT"]) {
+        const picked = pickTokenWindowsOfType(limits.filter((limit) => limit.type === type));
+        if (picked) {
+            return picked;
+        }
+    }
+    return null;
+}
 export function usageFromGlmQuota(quota, options) {
     if (!quota.success || !quota.data) {
         return null;

package/dist/install.js

@@ -170,7 +170,11 @@ function restartLaunchAgent(plistFile) {
     }
     try {
         execFileSync("launchctl", ["bootstrap", domain, plistFile]);
-        execFileSync("launchctl", ["kickstart", "-k", `${domain}/${LAUNCHD_LABEL}`]);
+        // No -k: bootout above already SIGTERMed any old instance, so the kill arm of
+        // "kickstart -k" can never fire here — and on macOS 26 (Tahoe) a SIGKILL from
+        // kickstart -k can wedge the job in "pended nondemand spawn", silently killing
+        // all automatic scheduling for it.
+        execFileSync("launchctl", ["kickstart", `${domain}/${LAUNCHD_LABEL}`]);
         return;
     }
     catch {

package/dist/menubar.d.ts

@@ -1,7 +1,11 @@
 import { RuntimePaths, StatusSnapshot } from "./types.js";
 export declare function resetGlyphSetCache(): void;
-export declare function readCompactMode(paths?: RuntimePaths): boolean;
-export declare function toggleCompactMode(paths?: RuntimePaths): boolean;
+export type TitleTier = "full" | "single" | "icon";
+export type TitleMode = "auto" | TitleTier;
+export declare function readTitleMode(paths?: RuntimePaths): TitleMode;
+export declare function writeTitleMode(mode: TitleMode, paths?: RuntimePaths): TitleMode;
+export declare function cycleTitleMode(paths?: RuntimePaths): TitleMode;
+export declare function pickTitleTier(display: StatusSnapshot["display"], providerCount: number): TitleTier;
 export declare function swiftBarPluginPath(paths?: RuntimePaths): {
     dir: string;
     file: string;

package/dist/menubar.js

@@ -120,27 +120,74 @@ function systemPrefersDark() {
 function appCliPath(paths) {
     return path.join(paths.stateDir, "app", "dist", "cli.js");
 }
-const COMPACT_MODE_FILE = "compact-mode";
-function compactModeFilePath(paths) {
-    return path.join(paths.stateDir, COMPACT_MODE_FILE);
+const TITLE_MODE_CYCLE = ["auto", "full", "single", "icon"];
+const TITLE_TIER_LABEL = {
+    full: "Full",
+    single: "Single",
+    icon: "Icon",
+};
+// Measured on a notched 13" (2560x1664, 1470pt logical, 645pt right of the
+// notch): the six-provider composite is 511pt wide including SwiftBar's item
+// padding, a single-provider one is 68pt. The system's own extras (clock,
+// Control Center, input menu, Spotlight) claim ~240pt before any third-party
+// icon shows up, so `full` needs a budget well beyond its own width to be
+// safe -- 645pt of notch-side bar cannot hold it even with nothing else
+// installed.
+const FULL_TIER_MIN_BUDGET_PT = 900;
+const SINGLE_TIER_MIN_BUDGET_PT = 350;
+// Name kept from the pre-tier boolean toggle: an existing empty marker file
+// means the user had compact on, which is the icon tier now.
+const TITLE_MODE_FILE = "compact-mode";
+function titleModeFilePath(paths) {
+    return path.join(paths.stateDir, TITLE_MODE_FILE);
 }
-export function readCompactMode(paths = buildPaths()) {
+export function readTitleMode(paths = buildPaths()) {
     try {
-        return fs.existsSync(compactModeFilePath(paths));
+        const raw = fs.readFileSync(titleModeFilePath(paths), "utf8").trim();
+        if (raw === "") {
+            return "icon";
+        }
+        return TITLE_MODE_CYCLE.includes(raw) ? raw : "auto";
     }
     catch {
-        return false;
+        // Absent file (and any unreadable state) means hands off: let the measured
+        // budget decide.
+        return "auto";
     }
 }
-export function toggleCompactMode(paths = buildPaths()) {
-    const filePath = compactModeFilePath(paths);
-    if (fs.existsSync(filePath)) {
+export function writeTitleMode(mode, paths = buildPaths()) {
+    const filePath = titleModeFilePath(paths);
+    if (mode === "auto") {
         fs.rmSync(filePath, { force: true });
-        return false;
+        return "auto";
     }
     ensureDir(paths.stateDir);
-    fs.writeFileSync(filePath, "");
-    return true;
+    fs.writeFileSync(filePath, `${mode}\n`);
+    return mode;
+}
+export function cycleTitleMode(paths = buildPaths()) {
+    const current = readTitleMode(paths);
+    const next = TITLE_MODE_CYCLE[(TITLE_MODE_CYCLE.indexOf(current) + 1) % TITLE_MODE_CYCLE.length];
+    return writeTitleMode(next, paths);
+}
+export function pickTitleTier(display, providerCount) {
+    if (providerCount === 0) {
+        return "icon";
+    }
+    const budget = display?.extrasBudgetPt;
+    if (typeof budget !== "number" || !Number.isFinite(budget)) {
+        // No measurement yet: fresh install, non-macOS host, or a failed probe.
+        // Assume the cramped case. Guessing `single` wrong costs detail; guessing
+        // `full` wrong costs the entire menu bar item.
+        return "single";
+    }
+    if (budget >= FULL_TIER_MIN_BUDGET_PT) {
+        return "full";
+    }
+    if (budget >= SINGLE_TIER_MIN_BUDGET_PT) {
+        return "single";
+    }
+    return "icon";
 }
 function configuredSwiftBarPluginDir(paths) {
     // Isolation escape hatch: an explicit CODING_USAGE_BAR_PLUGIN_DIR always wins and never
@@ -577,6 +624,56 @@ function titleIconParams() {
     }
     return { sfimage: "flame.fill", sfcolor: RAW_COLOR };
 }
+// Sort is stable per spec, so TITLE_PROVIDER_ORDER survives as the tie-break
+// and the same snapshot always elects the same provider. Byte-stable output is
+// what lets SwiftBar skip the menu rebuild.
+function mostUrgentProvider(providers) {
+    return [...providers].sort((left, right) => (STATE_PRIORITY[left.analysis.state] - STATE_PRIORITY[right.analysis.state]))[0];
+}
+// The invariant this whole ladder exists for: every path out of here carries a
+// visual. Missing assets, a PNG failure, an empty tier -- none of them may end
+// with an item that renders as nothing, because "renders as nothing" is
+// indistinguishable from "the tool is broken".
+function titleLine(tier, providers, title, topState, prefersDark) {
+    const iconLine = () => line("", {
+        sfimage: "flame.fill",
+        sfcolor: STATE_COLOR[topState],
+        dropdown: false,
+        tooltip: title,
+    });
+    if (tier === "icon") {
+        return iconLine();
+    }
+    const urgent = tier === "single" ? mostUrgentProvider(providers) : undefined;
+    const shown = urgent ? [urgent] : providers;
+    const image = titleImageValue(shown, prefersDark);
+    if (image) {
+        return line("", {
+            image: image.image,
+            width: image.width,
+            height: image.height,
+            dropdown: false,
+            tooltip: title,
+        });
+    }
+    const text = urgent ? titleSegment(urgent) : title;
+    return text
+        ? line(text, { ...titleIconParams(), dropdown: false })
+        : iconLine();
+}
+function titleModeLabel(mode, autoTier) {
+    return mode === "auto"
+        ? `Title  Auto (${TITLE_TIER_LABEL[autoTier]})`
+        : `Title  ${TITLE_TIER_LABEL[mode]}`;
+}
+// Carries the "why" behind a degraded title without spending a menu row on it.
+function titleModeTooltip(display, autoTier) {
+    if (!display || typeof display.extrasBudgetPt !== "number") {
+        return `Menu bar space unknown, assuming ${TITLE_TIER_LABEL[autoTier]}. Click to cycle Auto/Full/Single/Icon.`;
+    }
+    const shape = display.hasNotch ? "notched display" : "full-width menu bar";
+    return `${display.extrasBudgetPt}pt of menu bar space (${shape}) fits ${TITLE_TIER_LABEL[autoTier]}. Click to cycle Auto/Full/Single/Icon.`;
+}
 function anyProviderStale(snapshot) {
     return snapshot.providers.some((item) => item.meta.stale);
 }
@@ -733,52 +830,35 @@ function usageCardValue(snapshot, providers, glyphs, now, prefersDark) {
 // SwiftBar's content guard can skip the menu rebuild and menu bar repaint;
 // never render anything derived from wall-clock age or countdowns here.
 export function renderMenuBar(snapshot = loadDisplayStatusSnapshot(), paths = buildPaths(), now = new Date()) {
-    const compact = readCompactMode(paths);
+    const mode = readTitleMode(paths);
     const providers = titleProviders(snapshot);
     const title = providers.map(titleSegment).join(` ${TITLE_SEPARATOR} `);
-    const toggleParams = {
+    const autoTier = pickTitleTier(snapshot.display, providers.length);
+    const tier = mode === "auto" ? autoTier : mode;
+    const modeLine = line(titleModeLabel(mode, autoTier), {
         bash: stableNodeExecutable(),
         param1: appCliPath(paths),
         param2: "menubar",
-        param3: "toggle-compact",
+        param3: "cycle-title-mode",
         terminal: false,
         refresh: true,
         color: TEXT_COLOR,
-        sfimage: compact ? "rectangle.expand.vertical" : "rectangle.compress.vertical",
-    };
+        sfimage: "arrow.triangle.2.circlepath",
+        tooltip: titleModeTooltip(snapshot.display, autoTier),
+    });
     if (!title) {
         return [
             line("Coding Usage Bar  No Usage", { sfimage: "flame.fill", sfcolor: RAW_COLOR }),
             "---",
             line("No provider usage available", { color: MUTED_COLOR }),
-            line(compact ? "Expand" : "Collapse", toggleParams),
+            modeLine,
             line("Refresh now", { refresh: true, color: TEXT_COLOR, sfimage: "arrow.clockwise" }),
         ].join("\n");
     }
-    const topState = [...providers].sort((left, right) => (STATE_PRIORITY[left.analysis.state] - STATE_PRIORITY[right.analysis.state]))[0]?.analysis.state
-        ?? "RAW";
+    const topState = mostUrgentProvider(providers)?.analysis.state ?? "RAW";
     const prefersDark = systemPrefersDark();
-    const titleImage = titleImageValue(providers, prefersDark);
     const lines = [
-        compact
-            ? line("", {
-                sfimage: "flame.fill",
-                sfcolor: STATE_COLOR[topState],
-                dropdown: false,
-                tooltip: title,
-            })
-            : titleImage
-                ? line("", {
-                    image: titleImage.image,
-                    width: titleImage.width,
-                    height: titleImage.height,
-                    dropdown: false,
-                    tooltip: title,
-                })
-                : line(title, {
-                    ...titleIconParams(),
-                    dropdown: false,
-                }),
+        titleLine(tier, providers, title, topState, prefersDark),
         "---",
     ];
     const glyphs = glyphSetFor(paths);
@@ -866,7 +946,7 @@ export function renderMenuBar(snapshot = loadDisplayStatusSnapshot(), paths = bu
     if (visibleIssues.length > 0) {
         lines.push("---");
     }
-    lines.push(line(compact ? "Expand" : "Collapse", toggleParams));
+    lines.push(modeLine);
     lines.push(line("Refresh now", {
         refresh: true,
         color: TEXT_COLOR,

package/dist/runtime.d.ts

@@ -1,4 +1,4 @@
-import { BurnAnalysis, BurnProfile, ProviderUsage, RuntimePaths, StatusIssue, StatusSnapshot } from "./types.js";
+import { BurnAnalysis, BurnProfile, DisplayGeometry, ProviderUsage, RuntimePaths, StatusIssue, StatusSnapshot } from "./types.js";
 export declare function loadFixtureUsages(fixturesDir: string): ProviderUsage[];
 export declare function collectLocalState(options?: {
     fixtures?: boolean;
@@ -18,6 +18,7 @@ export declare function commitCollectedStatusSnapshot(usages: ProviderUsage[], i
     profile?: BurnProfile;
     generatedAt?: Date;
     fixtureSamples?: Map<string, ProviderUsage[]>;
+    display?: DisplayGeometry | null;
 }): StatusSnapshot;
 export declare function collectStatusSnapshot(options?: {
     fixtures?: boolean;

package/dist/runtime.js

@@ -6,6 +6,7 @@ import { collectCodexUsage } from "./codex.js";
 import { readJsonFile } from "./fs-util.js";
 import { collectGlmUsage } from "./glm.js";
 import { collectDeepseekUsage } from "./deepseek.js";
+import { probeDisplayGeometry } from "./display-probe.js";
 import { collectKimiUsage, resolveKimiConfig } from "./kimi.js";
 import { collectMinimaxUsage } from "./minimax.js";
 import { buildPaths } from "./paths.js";
@@ -258,6 +259,10 @@ export function commitCollectedStatusSnapshot(usages, issues, options = {}) {
         fixtureSamples: options.fixtureSamples,
         issues,
     });
+    // Measured outside the lock: it spawns a process and the lock guards a file
+    // write. A failed probe keeps the previous reading rather than blanking it,
+    // so one bad launchd context cannot demote the title tier.
+    const display = options.display === undefined ? probeDisplayGeometry(now) : options.display;
     return withStatusSnapshotLock(paths, () => {
         const existing = loadStatusSnapshot(paths);
         const cached = reconcileLatestUsages(usages, paths);
@@ -270,6 +275,7 @@ export function commitCollectedStatusSnapshot(usages, issues, options = {}) {
                 snapshot = replaceStatusSnapshotUsage(snapshot, provider.usage, now);
             }
         }
+        snapshot = { ...snapshot, display: display ?? existing?.display ?? null };
         saveStatusSnapshot(snapshot, paths);
         return snapshot;
     });

package/dist/types.d.ts

@@ -96,11 +96,18 @@ export interface StatusIssue {
     code: string;
     message: string;
 }
+export interface DisplayGeometry {
+    screenWidthPt: number;
+    hasNotch: boolean;
+    extrasBudgetPt: number;
+    measuredAt: string;
+}
 export interface StatusSnapshot {
     generatedAt: string;
     profile: BurnProfile;
     providers: ProviderStatus[];
     issues: StatusIssue[];
+    display?: DisplayGeometry | null;
 }
 export interface BurnConfig {
     providers: ProviderId[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-usage-bar",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "macOS menu bar usage monitor for Claude Code, Codex, GLM, DeepSeek, and MiniMax.",
   "author": "hanzhangzzz",
   "license": "MIT",