coding-usage-bar 0.4.1 → 0.5.1

package/README.md

@@ -17,7 +17,7 @@ Claude Code and Codex data stays local and is read from files those tools alread
 
 ## Live SwiftBar Menu
 
-The screenshot is captured from the live SwiftBar plugin. The animation reproduces opening and closing that menu without altering the captured usage data.
+The menu bar title and the dropdown panel are captured from the live SwiftBar plugin and placed on a plain backdrop. The animation reproduces opening and closing that menu without altering the captured usage data.
 
 <p align="center">
   <img src="docs/assets/demo.gif" alt="Opening the live Coding Usage Bar SwiftBar menu with Codex, Claude, GLM, DeepSeek, MiniMax, and Kimi usage" width="800">
@@ -33,6 +33,22 @@ coding-usage-bar status
 
 `install` creates a local runtime at `~/.coding-usage-bar/app`, a user-level CLI shim at `~/.local/bin/coding-usage-bar`, a launchd agent, a default config file, and a SwiftBar menu bar plugin. Make sure `~/.local/bin` is in your `PATH`.
 
+## 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.
+2. macOS may fold menu bar icons away: check System Settings → Control Center → Menu Bar.
+3. If macOS showed an Automation permission prompt (System Events) and it was denied, SwiftBar cannot auto-start at login: allow it under System Settings → Privacy & Security → Automation, then run `coding-usage-bar install` again.
+
+`coding-usage-bar install` verifies at the end that the plugin actually renders and prints `Menu bar ready`; if that line is missing, the numbered steps it prints tell you exactly what to do.
+
 ## Commands
 
 | Command | Purpose |
@@ -40,10 +56,12 @@ coding-usage-bar status
 | `coding-usage-bar install` | Install runtime, launchd checker, SwiftBar host/plugin, and Claude ingest when safe |
 | `coding-usage-bar uninstall` | Remove Coding Usage Bar managed launchd/status line/plugin config |
 | `coding-usage-bar doctor` | Check local Codex/Claude/GLM usage sources and notification backend |
+| `coding-usage-bar doctor --fix` | Repair common issues: missing SwiftBar/plugin, SwiftBar not running, login item, status data |
 | `coding-usage-bar status` | Print the rolling windows reported by each account and their pacing state from `~/.coding-usage-bar/status.json` |
 | `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 |
@@ -182,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
@@ -190,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/README.zh-CN.md

@@ -12,7 +12,7 @@ Claude Code 与 Codex 的数据直接读取它们在本机产生的文件，不
 
 ## 真实 SwiftBar 菜单
 
-以下截图来自正在运行的 SwiftBar 插件；动画复现菜单的展开与收起，不修改截图中的用量数据。
+菜单栏标题与下拉面板均截自正在运行的 SwiftBar 插件，仅叠加纯色桌面背景；动画复现菜单的展开与收起，不修改截图中的用量数据。
 
 <p align="center">
   <img src="docs/assets/demo.gif" alt="打开 Coding Usage Bar 的真实 SwiftBar 菜单，查看 Codex、Claude、GLM、DeepSeek、MiniMax 和 Kimi 用量" width="800">
@@ -33,6 +33,16 @@ coding-usage-bar status
 - 每 5 分钟采集一次用量的 launchd 任务
 - 写入 SwiftBar 当前插件目录的菜单栏插件
 
+安装结束时会自动验收菜单栏是否就绪，最后一行出现 `Menu bar ready` 即表示图标已出现在菜单栏右上角。
+
+## 常见问题
+
+**安装后菜单栏没有图标？**
+
+1. 执行 `coding-usage-bar doctor --fix`：自动重启 SwiftBar、补装菜单栏插件、补加 SwiftBar 登录项、补采 status 数据。
+2. macOS 可能把菜单栏图标折叠隐藏了：系统设置 → 控制中心 → 菜单栏，检查隐藏区。
+3. 如果 macOS 弹过 System Events 的"自动化"权限框且被拒绝，SwiftBar 将无法开机自启：在 系统设置 → 隐私与安全性 → 自动化 中放行，再执行一次 `coding-usage-bar install`。
+
 ## 核心特点
 
 - 一个菜单栏同时查看多个 AI 编程 Provider

package/dist/cli.js

@@ -5,8 +5,8 @@ import { saveUsage } from "./store.js";
 import { formatStatusRows, formatAnalysisDetail, formatIssues, formatProviderMeta } from "./format.js";
 import { loadDisplayStatusSnapshot, collectStatusSnapshot } from "./runtime.js";
 import { runDaemonOnce } from "./daemon.js";
-import { doctorHasFailures, formatDoctor, runDoctor } from "./doctor.js";
-import { installMenuBar, renderMenuBar, uninstallMenuBar, toggleCompactMode } from "./menubar.js";
+import { doctorHasFailures, formatDoctor, runDoctor, runDoctorFix } from "./doctor.js";
+import { installMenuBar, renderMenuBar, uninstallMenuBar, cycleTitleMode } from "./menubar.js";
 import { buildPaths } from "./paths.js";
 import { bakeGlyphAtlases } from "./glyphs.js";
 import { maybePromptForStar } from "./star.js";
@@ -20,12 +20,12 @@ function printHelp() {
 Usage:
   coding-usage-bar install [--dry-run]
   coding-usage-bar uninstall [--dry-run]
-  coding-usage-bar doctor [--dry-run]
+  coding-usage-bar doctor [--dry-run] [--fix]
   coding-usage-bar status [--fixtures] [--json] [--refresh]
   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]
@@ -57,9 +57,21 @@ async function main() {
             return;
         }
         if (command === "doctor") {
+            const fix = hasFlag(args, "--fix");
+            if (fix) {
+                const fixes = await runDoctorFix({ dryRun });
+                if (fixes.length > 0) {
+                    console.log(fixes.join("\n"));
+                    console.log("");
+                }
+            }
             const checks = runDoctor({ dryRun });
             console.log(formatDoctor(checks));
             if (doctorHasFailures(checks)) {
+                if (!fix) {
+                    console.log("");
+                    console.log("Run coding-usage-bar doctor --fix to repair common issues automatically.");
+                }
                 process.exitCode = 1;
             }
             return;
@@ -106,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/doctor.d.ts

@@ -2,5 +2,25 @@ import { DoctorCheck } from "./types.js";
 export declare function runDoctor(options?: {
     dryRun?: boolean;
 }): DoctorCheck[];
+export interface DoctorFixProbes {
+    swiftBarInstalled?: () => boolean;
+    pluginPresent?: () => boolean;
+    swiftBarRunning?: () => boolean;
+    swiftBarInLoginItems?: () => boolean | null;
+    statusFilePresent?: () => boolean;
+}
+export interface DoctorFixEffects {
+    installSwiftBar?: () => string[];
+    installPlugin?: () => string[];
+    launchSwiftBar?: () => string[];
+    addLoginItem?: () => string[];
+    collectStatus?: () => Promise<string[]>;
+}
+export interface DoctorFixOptions {
+    dryRun?: boolean;
+    probes?: DoctorFixProbes;
+    effects?: DoctorFixEffects;
+}
+export declare function runDoctorFix(options?: DoctorFixOptions): Promise<string[]>;
 export declare function formatDoctor(checks: DoctorCheck[]): string;
 export declare function doctorHasFailures(checks: DoctorCheck[]): boolean;

package/dist/doctor.js

@@ -7,7 +7,8 @@ import { isDir, isFile } from "./fs-util.js";
 import { resolveKimiConfig } from "./kimi.js";
 import { buildPaths, providerLatestPath } from "./paths.js";
 import { notificationBackend } from "./notifier.js";
-import { isSwiftBarInstalled, isSwiftBarRunning, swiftBarPluginPath } from "./menubar.js";
+import { addSwiftBarToLoginItems, ensureSwiftBarInstalled, installMenuBar, isSwiftBarInstalled, isSwiftBarInLoginItems, isSwiftBarRunning, openSwiftBar, swiftBarPluginPath, } from "./menubar.js";
+import { runDaemonOnce } from "./daemon.js";
 function stableClaudeIngestHint() {
     const paths = buildPaths();
     return `printf "%s" "$input" | node "${paths.stateDir}/app/dist/cli.js" ingest claude-statusline >/dev/null`;
@@ -240,17 +241,96 @@ export function runDoctor(options = {}) {
     const swiftBarRunning = pluginPresent && isSwiftBarRunning();
     checks.push({
         name: "Menu bar",
-        ok: pluginPresent,
+        ok: pluginPresent && swiftBarRunning,
         message: swiftBarInstalled
             ? isFile(swiftBarPlugin.file)
                 ? swiftBarRunning
                     ? `SwiftBar plugin installed and SwiftBar running: ${swiftBarPlugin.file}`
-                    : `SwiftBar plugin installed but SwiftBar is not running (menu bar item hidden); run: open -a SwiftBar`
-                : `SwiftBar found; run coding-usage-bar menubar install`
-            : "SwiftBar not found; install SwiftBar, then run coding-usage-bar menubar install",
+                    : "SwiftBar plugin installed but SwiftBar is not running (menu bar item hidden); run: coding-usage-bar doctor --fix"
+                : "SwiftBar found; run: coding-usage-bar doctor --fix"
+            : "SwiftBar not found; run: coding-usage-bar doctor --fix (installs SwiftBar via Homebrew)",
+    });
+    if (process.platform === "darwin") {
+        if (options.dryRun) {
+            checks.push({
+                name: "SwiftBar login item",
+                ok: true,
+                message: "[dry-run] would check whether SwiftBar auto-starts at login",
+            });
+        }
+        else if (!swiftBarInstalled) {
+            checks.push({
+                name: "SwiftBar login item",
+                ok: true,
+                message: "skipped (SwiftBar not installed)",
+            });
+        }
+        else {
+            const inLoginItems = isSwiftBarInLoginItems();
+            checks.push({
+                name: "SwiftBar login item",
+                ok: inLoginItems !== false,
+                message: inLoginItems === null
+                    ? "could not verify (Automation permission denied?); if the icon disappears after reboot, check System Settings → General → Login Items"
+                    : inLoginItems
+                        ? "SwiftBar auto-starts at login"
+                        : "not in login items; the menu bar icon disappears after reboot. Run: coding-usage-bar doctor --fix",
+            });
+        }
+    }
+    checks.push({
+        name: "Status data",
+        ok: options.dryRun ? true : isFile(paths.statusFile),
+        message: options.dryRun
+            ? `[dry-run] would read ${paths.statusFile}`
+            : isFile(paths.statusFile)
+                ? `found ${paths.statusFile}`
+                : `missing ${paths.statusFile}; run coding-usage-bar doctor --fix or coding-usage-bar daemon --once`,
     });
     return checks;
 }
+// One-command self-healing for the common "installed but the menu bar icon is
+// gone" failures: missing SwiftBar, missing plugin, SwiftBar not running,
+// SwiftBar missing from login items, and missing status data.
+export async function runDoctorFix(options = {}) {
+    if (options.dryRun) {
+        return ["[dry-run] would repair SwiftBar, the menu bar plugin, login items, and status data automatically"];
+    }
+    const paths = buildPaths();
+    const probes = {
+        swiftBarInstalled: options.probes?.swiftBarInstalled ?? isSwiftBarInstalled,
+        pluginPresent: options.probes?.pluginPresent ?? (() => isFile(swiftBarPluginPath(paths).file)),
+        swiftBarRunning: options.probes?.swiftBarRunning ?? isSwiftBarRunning,
+        swiftBarInLoginItems: options.probes?.swiftBarInLoginItems ?? isSwiftBarInLoginItems,
+        statusFilePresent: options.probes?.statusFilePresent ?? (() => isFile(paths.statusFile)),
+    };
+    const effects = {
+        installSwiftBar: options.effects?.installSwiftBar ?? (() => ensureSwiftBarInstalled()),
+        installPlugin: options.effects?.installPlugin ?? (() => installMenuBar()),
+        launchSwiftBar: options.effects?.launchSwiftBar ?? (() => openSwiftBar()),
+        addLoginItem: options.effects?.addLoginItem ?? (() => addSwiftBarToLoginItems()),
+        collectStatus: options.effects?.collectStatus ?? (async () => runDaemonOnce()),
+    };
+    const messages = [];
+    let swiftBarInstalled = probes.swiftBarInstalled();
+    if (!swiftBarInstalled) {
+        messages.push(...effects.installSwiftBar());
+        swiftBarInstalled = probes.swiftBarInstalled();
+    }
+    if (!probes.pluginPresent()) {
+        messages.push(...effects.installPlugin());
+    }
+    if (swiftBarInstalled && !probes.swiftBarRunning()) {
+        messages.push(...effects.launchSwiftBar());
+    }
+    if (probes.swiftBarInLoginItems() === false) {
+        messages.push(...effects.addLoginItem());
+    }
+    if (!probes.statusFilePresent()) {
+        messages.push(...(await effects.collectStatus()));
+    }
+    return messages;
+}
 export function formatDoctor(checks) {
     return checks
         .map((check) => `${check.ok ? "OK" : "MISSING"}  ${check.name}: ${check.message}`)

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

@@ -5,7 +5,7 @@ import { execFileSync } from "node:child_process";
 import { claudeStatusLineHasIngest, getClaudeStatusLineCommand, readClaudeSettings } from "./claude.js";
 import { ensureConfig, readConfig } from "./config.js";
 import { ensureDir, isFile, readJsonFile, writeJsonAtomic } from "./fs-util.js";
-import { addSwiftBarToLoginItems, ensureSwiftBarInstalled, installMenuBar, openSwiftBar, uninstallMenuBar } from "./menubar.js";
+import { addSwiftBarToLoginItems, ensureSwiftBarInstalled, installMenuBar, openSwiftBar, uninstallMenuBar, verifyMenuBarSetup } from "./menubar.js";
 import { bakeGlyphAtlases } from "./glyphs.js";
 import { buildPaths } from "./paths.js";
 import { stableNodeExecutable } from "./node-runtime.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 {
@@ -376,11 +380,13 @@ export function install(options = {}) {
     if (dryRun) {
         messages.push(`[dry-run] would write launchd plist: ${paths.launchAgentFile}`);
         messages.push(`[dry-run] ProgramArguments: ${[...args, "daemon", "--once"].join(" ")}`);
+        messages.push(...verifyMenuBarSetup({ dryRun }));
         return messages;
     }
     fs.writeFileSync(paths.launchAgentFile, xml, "utf8");
     restartLaunchAgent(paths.launchAgentFile);
     messages.push(`Installed and restarted launchd agent: ${paths.launchAgentFile}`);
+    messages.push(...verifyMenuBarSetup());
     return messages;
 }
 export function uninstall(options = {}) {

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;
@@ -12,9 +16,24 @@ export declare function ensureSwiftBarInstalled(options?: {
 }): string[];
 export declare function isSwiftBarRunning(): boolean;
 export declare function openSwiftBar(): string[];
+export declare function isSwiftBarInLoginItems(): boolean | null;
 export declare function addSwiftBarToLoginItems(options?: {
     dryRun?: boolean;
 }): string[];
+export interface PluginRunResult {
+    ok: boolean;
+    output: string;
+}
+export interface VerifyMenuBarOptions {
+    dryRun?: boolean;
+    runPlugin?: (file: string) => PluginRunResult;
+    loginItems?: () => boolean | null;
+    swiftBarInstalled?: () => boolean;
+    swiftBarRunning?: () => boolean;
+    repairPlugin?: () => string[];
+    launchSwiftBar?: () => string[];
+}
+export declare function verifyMenuBarSetup(options?: VerifyMenuBarOptions): string[];
 export declare function renderMenuBar(snapshot?: StatusSnapshot, paths?: RuntimePaths, now?: Date): string;
 export declare function swiftBarStatusItemVisibilityKeys(defaultsOutput: string): string[];
 export declare function installMenuBar(options?: {

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
@@ -268,22 +315,27 @@ export function openSwiftBar() {
     }
     return messages;
 }
-export function addSwiftBarToLoginItems(options = {}) {
-    const dryRun = options.dryRun ?? false;
-    const appPath = swiftBarAppPath();
-    if (!appPath) {
-        return ["SwiftBar is not installed; skipping login item."];
-    }
+// Whether SwiftBar auto-starts at login. Returns null when the login item list
+// cannot be queried (Automation permission denied or non-interactive context).
+export function isSwiftBarInLoginItems() {
     try {
         const result = execFileSync("osascript", [
             "-e", 'tell application "System Events" to get the name of every login item',
         ], { encoding: "utf8" });
-        if (result.includes("SwiftBar")) {
-            return ["SwiftBar already in login items."];
-        }
+        return result.split(",").map((name) => name.trim()).includes("SwiftBar");
     }
     catch {
-        // Permission or access issue; try to add anyway.
+        return null;
+    }
+}
+export function addSwiftBarToLoginItems(options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const appPath = swiftBarAppPath();
+    if (!appPath) {
+        return ["SwiftBar is not installed; skipping login item."];
+    }
+    if (isSwiftBarInLoginItems()) {
+        return ["SwiftBar already in login items."];
     }
     if (dryRun) {
         return [`[dry-run] would add SwiftBar to login items: ${appPath}`];
@@ -298,6 +350,69 @@ export function addSwiftBarToLoginItems(options = {}) {
         return [`Failed to add SwiftBar to login items: ${error instanceof Error ? error.message : String(error)}. Add manually in System Settings → General → Login Items.`];
     }
 }
+// Execute the installed plugin exactly the way SwiftBar would and check it
+// produces a real menu. The plugin prints "Usage ERR" with exit code 0 on
+// failure, so a non-error status alone proves nothing.
+function runPluginScript(file) {
+    try {
+        const stdout = execFileSync(file, { encoding: "utf8", timeout: 30000 });
+        const output = stdout.trim();
+        return { ok: output.length > 0 && !output.startsWith("Usage ERR"), output };
+    }
+    catch (error) {
+        return { ok: false, output: error instanceof Error ? error.message : String(error) };
+    }
+}
+const MENU_BAR_MANUAL_STEPS = [
+    "Menu bar is NOT ready yet. Fix it with these steps:",
+    "  1. If macOS is showing an Automation/Accessibility permission prompt, click Allow.",
+    "  2. Open SwiftBar: open -a SwiftBar",
+    "  3. If the icon is still missing, macOS may have folded it away: System Settings → Control Center → Menu Bar.",
+    "  4. Re-run: coding-usage-bar doctor --fix",
+];
+const LOGIN_ITEM_WARNING = [
+    "WARN SwiftBar is not in login items: the menu bar icon will disappear after a reboot.",
+    "     If macOS showed a System Events Automation prompt, allow it and re-run coding-usage-bar install,",
+    "     or add SwiftBar manually: System Settings → General → Login Items.",
+];
+// End-to-end acceptance at the end of install: the plugin exists, SwiftBar is
+// running, and the plugin actually renders a menu. Auto-repairs once, then
+// falls back to numbered manual steps instead of failing silently.
+export function verifyMenuBarSetup(options = {}) {
+    if (options.dryRun) {
+        return ["[dry-run] would verify the SwiftBar plugin renders and the menu bar item appears"];
+    }
+    const paths = buildPaths();
+    const plugin = swiftBarPluginPath(paths);
+    const isInstalled = options.swiftBarInstalled ?? isSwiftBarInstalled;
+    const isRunning = options.swiftBarRunning ?? isSwiftBarRunning;
+    const messages = [];
+    if (!isInstalled()) {
+        return [
+            ...MENU_BAR_MANUAL_STEPS,
+            `  (SwiftBar is not installed. Install it with: brew install --cask swiftbar, then re-run coding-usage-bar install.)`,
+        ];
+    }
+    if (!isFile(plugin.file)) {
+        messages.push(...(options.repairPlugin ?? installMenuBar)());
+    }
+    if (!isRunning()) {
+        messages.push(...(options.launchSwiftBar ?? openSwiftBar)());
+    }
+    if (!isFile(plugin.file)) {
+        return [...messages, ...MENU_BAR_MANUAL_STEPS, `  (Plugin file missing: ${plugin.file})`];
+    }
+    const run = (options.runPlugin ?? runPluginScript)(plugin.file);
+    if (!run.ok || !isRunning()) {
+        return [...messages, ...MENU_BAR_MANUAL_STEPS];
+    }
+    messages.push("");
+    messages.push("Menu bar ready — Coding Usage Bar should now appear at the top-right of your menu bar.");
+    if ((options.loginItems ?? isSwiftBarInLoginItems)() === false) {
+        messages.push(...LOGIN_ITEM_WARNING);
+    }
+    return messages;
+}
 function swiftBarEscape(value) {
     return value.replaceAll("|", "\\|");
 }
@@ -509,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);
 }
@@ -665,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);
@@ -798,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.4.1",
+  "version": "0.5.1",
   "description": "macOS menu bar usage monitor for Claude Code, Codex, GLM, DeepSeek, and MiniMax.",
   "author": "hanzhangzzz",
   "license": "MIT",
@@ -29,7 +29,7 @@
   ],
   "type": "module",
   "bin": {
-    "coding-usage-bar": "./dist/cli.js"
+    "coding-usage-bar": "dist/cli.js"
   },
   "files": [
     "assets",