coding-usage-bar 0.5.0 → 0.6.0

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 |
@@ -107,6 +114,8 @@ Coding Usage Bar calls the Zhipu AI quota API (`GET /api/monitor/usage/quota/lim
 
 Get your API key from the [Zhipu AI console](https://open.bigmodel.cn). Without this key, GLM monitoring will report `GLM_API_KEY_MISSING`.
 
+Zhipu meters newer Coding Plans in credits (积分) instead of raw tokens and reports them as `CREDIT_LIMIT` windows. Coding Usage Bar keys off the response shape, records `quotaUnit` as `credits` or `tokens` in `status.json`, and labels the dropdown with `metered in credits` so the 5h/7d percentages read correctly for either plan generation. This detection has not been verified against a real V3 (points-based) account yet; it is based on the `CREDIT_LIMIT` shape observed on existing plans. If you are on a V3 plan, a redacted `coding-usage-bar status --refresh` output in an issue would confirm it.
+
 ## DeepSeek
 
 Coding Usage Bar calls `GET https://api.deepseek.com/user/balance` to read your account balance. DeepSeek exposes balance rather than 5h/7d usage windows, so the menu bar shows `Available` or `Depleted` plus the currency amount. Set `deepseek.apiKey` in `~/.coding-usage-bar/config.json`:
@@ -122,6 +131,17 @@ Coding Usage Bar calls `GET https://api.deepseek.com/user/balance` to read your
 
 Without this key, DeepSeek monitoring will report `DEEPSEEK_API_KEY_MISSING`.
 
+## Peak and off-peak pricing
+
+GLM Coding Plan and the DeepSeek API both publish a clock-based discount, and both state it in Beijing time. Coding Usage Bar computes the current tier on the producer side, stores it in `status.json` as `pricing`, and shows it in the CLI table (`price` row), the dropdown, and the usage card, together with the time of the next flip:
+
+| Provider | Peak (Asia/Shanghai) | Off-peak | Holidays |
+|---|---|---|---|
+| DeepSeek API | Mon–Fri 09:00–12:00 and 14:00–18:00 | 50% of the peak rate | Chinese public holidays are off-peak all day |
+| GLM Coding Plan | Mon–Fri 14:00–18:00 | credits deducted at 50% | Not excluded by the published rule |
+
+Sources: [DeepSeek pricing](https://api-docs.deepseek.com/quick_start/pricing) and the [GLM Coding Plan overview](https://docs.bigmodel.cn/cn/coding-plan/overview). The 2026 holiday table follows the State Council notice (国办发明电〔2025〕7号); adjusted working weekends stay off-peak because both vendors phrase the rule as Monday to Friday. Time-boxed promotions are not modelled. The tier only tells you what the provider charges right now; it does not change the burn analysis.
+
 ## MiniMax (M3)
 
 Coding Usage Bar calls `GET https://api.minimaxi.com/v1/token_plan/remains` to read 5h and 7d usage windows. MiniMax returns two signals per model: a count-based ratio (`current_*_usage_count` / `current_*_total_count`) for tiered models like `video`, and a credit-based `current_*_remaining_percent` (0-100) for the `general` model where the count stays at 0. Coding Usage Bar prefers the count ratio when total > 0 and otherwise derives used% as `100 - remaining_percent`. Set `minimax.apiKey` and (optionally) `minimax.region` in `~/.coding-usage-bar/config.json`:
@@ -193,6 +213,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 +237,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

@@ -50,6 +50,17 @@ coding-usage-bar status
 - Claude Code、Codex 本地优先，不依赖额外遥测服务
 - 展示层只读稳定的 `status.json`，不会在打开菜单时临时访问数据源
 - 接近限额或燃烧节奏异常时发送系统通知
+- 国产套餐规则内置：GLM Coding Plan 与 DeepSeek 的峰谷时段按北京时间计算，法定节假日按国办通知处理，CLI、下拉菜单和卡片都会显示当前是高峰还是谷时、几折、几点切换
+- GLM 新版 Coding Plan 按积分（`CREDIT_LIMIT`）计量时自动识别，标注"按积分计量"，5h/7d 百分比不会因为套餐换代而失真。该识别基于现有套餐观测到的 `CREDIT_LIMIT` 形状，尚未用真实 V3 积分制账号实测；V3 用户可在 issue 里贴脱敏的 `coding-usage-bar status --refresh` 输出帮助确认
+
+## 峰谷时段
+
+| Provider | 高峰（北京时间） | 谷时 | 法定节假日 |
+|---|---|---|---|
+| DeepSeek API | 周一至周五 09:00–12:00、14:00–18:00 | 高峰价的 50% | 全天谷时 |
+| GLM Coding Plan | 周一至周五 14:00–18:00 | 积分按 50% 抵扣 | 官方规则未排除，按工作日字面处理 |
+
+依据 [DeepSeek 定价页](https://api-docs.deepseek.com/quick_start/pricing)与 [GLM Coding Plan 概览](https://docs.bigmodel.cn/cn/coding-plan/overview)。2026 年节假日表来自国办发明电〔2025〕7号；调休上班的周末仍按周末处理，因为两家都把规则写成"周一至周五"。限时活动（如双节全天谷时）不建模。峰谷只说明厂商此刻怎么计费，不改变燃烧节奏分析。
 
 完整命令、Provider 配置和实现边界请查看[英文 README](README.md)。
 

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/deepseek.js

@@ -1,3 +1,4 @@
+import { deepseekPricing } from "./pricing.js";
 const DEFAULT_BASE_URL = "https://api.deepseek.com";
 export async function fetchDeepseekBalance(config) {
     const url = `${DEFAULT_BASE_URL}/user/balance`;
@@ -19,11 +20,13 @@ export function usageFromDeepseekBalance(balance, options) {
     if (!info) {
         return null;
     }
+    const observedAt = options.observedAt ?? new Date().toISOString();
     return {
         provider: "deepseek",
         source: options.source,
-        observedAt: options.observedAt ?? new Date().toISOString(),
+        observedAt,
         planType: null,
+        pricing: deepseekPricing(new Date(observedAt)),
         windows: [],
         balance: {
             total: info.total_balance,

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/format.js

@@ -62,10 +62,24 @@ export function usageBar(usedPercent, width = 12) {
     const usedCells = Math.max(0, Math.min(width, Math.round((usedPercent / 100) * width)));
     return `[${"#".repeat(usedCells)}${"-".repeat(width - usedCells)}] ${Math.round(usedPercent)}%`;
 }
+function pricingRow(usage) {
+    if (!usage.pricing) {
+        return null;
+    }
+    const tier = usage.pricing.tier === "off_peak" ? `off-peak ${usage.pricing.discountPercent}% off` : "peak, full price";
+    return [
+        providerLabel(usage.provider).padEnd(8),
+        "price".padEnd(8),
+        tier.padEnd(19),
+        formatDurationUntil(usage.pricing.until).padEnd(10),
+        usage.quotaUnit === "credits" ? "credits" : "",
+    ].join("");
+}
 export function formatStatusRows(usages, analyses) {
     const rows = ["Provider  Period  Usage              Reset     State"];
     for (const usage of usages) {
         const analysis = analyses.find((item) => item.provider === usage.provider);
+        const price = pricingRow(usage);
         if (usage.balance && usage.windows.length === 0) {
             const currency = usage.balance.currency === "CNY" ? "¥" : "$";
             rows.push([
@@ -75,6 +89,8 @@ export function formatStatusRows(usages, analyses) {
                 "".padEnd(10),
                 analysis?.state ?? "RAW",
             ].join(""));
+            if (price)
+                rows.push(price);
             continue;
         }
         for (const window of usage.windows) {
@@ -86,6 +102,8 @@ export function formatStatusRows(usages, analyses) {
                 analysis?.state ?? "RAW",
             ].join(""));
         }
+        if (price)
+            rows.push(price);
     }
     return rows.join("\n");
 }

package/dist/glm.js

@@ -1,4 +1,5 @@
 import { makeProviderUsage, normalizeWindow } from "./usage.js";
+import { glmPricing } from "./pricing.js";
 const DEFAULT_BASE_URL = "https://open.bigmodel.cn";
 export async function fetchGlmQuota(config) {
     const baseUrl = config.baseUrl || DEFAULT_BASE_URL;
@@ -30,15 +31,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 +43,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, unit: type === "CREDIT_LIMIT" ? "credits" : "tokens" };
+        }
+    }
+    return null;
+}
 export function usageFromGlmQuota(quota, options) {
     if (!quota.success || !quota.data) {
         return null;
@@ -68,7 +78,7 @@ export function usageFromGlmQuota(quota, options) {
     if (!fiveHour || !sevenDay) {
         return null;
     }
-    return makeProviderUsage({
+    const usage = makeProviderUsage({
         provider: "glm",
         source: options.source,
         observedAt: options.observedAt,
@@ -76,6 +86,11 @@ export function usageFromGlmQuota(quota, options) {
         fiveHour,
         sevenDay,
     });
+    return {
+        ...usage,
+        quotaUnit: picked.unit,
+        pricing: glmPricing(new Date(usage.observedAt)),
+    };
 }
 export async function collectGlmUsage(config) {
     if (!config.apiKey) {

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

@@ -4,6 +4,7 @@ import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { ensureDir, isFile } from "./fs-util.js";
 import { formatProviderLabel, formatResetTime } from "./format.js";
+import { pricingLabel } from "./pricing.js";
 import { buildPaths } from "./paths.js";
 import { stableNodeExecutable } from "./node-runtime.js";
 import { loadDisplayStatusSnapshot } from "./runtime.js";
@@ -120,27 +121,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 +625,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);
 }
@@ -671,7 +769,9 @@ function cardProviderBlock(item, now) {
             darkColor,
             headline: `${currency}${item.usage.balance.total}`,
             rows: [],
-            note: "Pay-as-you-go · no windowed quota",
+            note: item.usage.pricing
+                ? `Pay-as-you-go · ${pricingLabel(item.usage.pricing, formatResetTime(item.usage.pricing.until, now))}`
+                : "Pay-as-you-go · no windowed quota",
             message: null,
             updated: observedUpdatedLabel(item, now),
         };
@@ -695,7 +795,9 @@ function cardProviderBlock(item, now) {
         darkColor,
         headline: headlinePct ? `${Math.round(headlinePct.usedPercent)}%` : STATE_LABEL[item.analysis.state],
         rows,
-        note: null,
+        note: item.usage.pricing
+            ? `${pricingLabel(item.usage.pricing, formatResetTime(item.usage.pricing.until, now))}${item.usage.quotaUnit === "credits" ? " · credits" : ""}`
+            : null,
         message: shortCardMessage(item),
         updated: observedUpdatedLabel(item, now),
     };
@@ -733,52 +835,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);
@@ -821,6 +906,9 @@ export function renderMenuBar(snapshot = loadDisplayStatusSnapshot(), paths = bu
                     font: ROW_FONT,
                     size: 12,
                 }));
+                if (item.usage.pricing) {
+                    lines.push(muted(pricingLabel(item.usage.pricing, formatResetTime(item.usage.pricing.until, now))));
+                }
                 lines.push(line(item.analysis.message, { color: MUTED_COLOR, size: 12, length: 84 }));
                 lines.push("---");
                 continue;
@@ -840,6 +928,10 @@ export function renderMenuBar(snapshot = loadDisplayStatusSnapshot(), paths = bu
             if (item.usage.blocked) {
                 lines.push(muted(`Blocked  ${item.usage.blocked.reason}. 5h/7d numbers above still reflect the window quotas.`));
             }
+            if (item.usage.pricing) {
+                const unit = item.usage.quotaUnit === "credits" ? " · metered in credits" : "";
+                lines.push(muted(`${pricingLabel(item.usage.pricing, formatResetTime(item.usage.pricing.until, now))}${unit}`));
+            }
             lines.push(muted(targetLabel(item)));
             lines.push(line(item.analysis.message, { color: MUTED_COLOR, size: 12, length: 84 }));
             lines.push("---");
@@ -866,7 +958,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/pricing.d.ts

@@ -0,0 +1,5 @@
+import { PricingInfo } from "./types.js";
+export declare function isCnPublicHoliday(date: Date): boolean;
+export declare function deepseekPricing(now?: Date): PricingInfo;
+export declare function glmPricing(now?: Date): PricingInfo;
+export declare function pricingLabel(pricing: PricingInfo, until: string): string;

package/dist/pricing.js

@@ -0,0 +1,115 @@
+// Peak / off-peak pricing tiers for the two providers that publish a clock-based
+// discount. Both rules are stated by the vendor in Beijing time (UTC+8, no DST),
+// so the arithmetic below deliberately avoids the host time zone.
+//
+// DeepSeek (api-docs.deepseek.com/quick_start/pricing): peak is 01:00-04:00 and
+// 06:00-10:00 UTC, Monday through Friday, excluding Chinese public holidays;
+// every other hour is off-peak at 50% of the peak rate. In Beijing time that is
+// 09:00-12:00 and 14:00-18:00.
+//
+// GLM Coding Plan V3 (docs.bigmodel.cn/cn/coding-plan/overview): 高峰时段 is
+// 每周一至周五的 14:00~18:00 (UTC+8) at the base credit deduction; all other
+// hours deduct 50% of the base credits. The page does not exclude public
+// holidays, and time-boxed promotions (e.g. all-day off-peak during a holiday
+// campaign) are not modelled here: the tier follows the standing rule only.
+const BEIJING_OFFSET_MINUTES = 8 * 60;
+const MINUTES_PER_DAY = 24 * 60;
+const LOOKAHEAD_DAYS = 40;
+// Rest days from 国务院办公厅关于2026年部分节假日安排的通知 (国办发明电〔2025〕7号,
+// 2025-11-04). Adjusted working weekends (调休上班) are intentionally not
+// promoted to weekdays: both vendors phrase the peak rule as Monday-Friday.
+const CN_PUBLIC_HOLIDAYS = {
+    2026: new Set([
+        "01-01", "01-02", "01-03",
+        "02-15", "02-16", "02-17", "02-18", "02-19", "02-20", "02-21", "02-22", "02-23",
+        "04-04", "04-05", "04-06",
+        "05-01", "05-02", "05-03", "05-04", "05-05",
+        "06-19", "06-20", "06-21",
+        "09-25", "09-26", "09-27",
+        "10-01", "10-02", "10-03", "10-04", "10-05", "10-06", "10-07",
+    ]),
+};
+const DEEPSEEK_RULE = {
+    peakSegments: [[9 * 60, 12 * 60], [14 * 60, 18 * 60]],
+    excludePublicHolidays: true,
+    offPeakDiscountPercent: 50,
+    rule: "DeepSeek API: peak Mon-Fri 09:00-12:00 & 14:00-18:00 Asia/Shanghai excluding CN public holidays; off-peak 50% off",
+};
+const GLM_RULE = {
+    peakSegments: [[14 * 60, 18 * 60]],
+    excludePublicHolidays: false,
+    offPeakDiscountPercent: 50,
+    rule: "GLM Coding Plan: peak Mon-Fri 14:00-18:00 Asia/Shanghai; off-peak credits deducted at 50%",
+};
+function beijingParts(date) {
+    const shifted = new Date(date.getTime() + BEIJING_OFFSET_MINUTES * 60_000);
+    return {
+        year: shifted.getUTCFullYear(),
+        month: shifted.getUTCMonth() + 1,
+        day: shifted.getUTCDate(),
+        weekday: shifted.getUTCDay(),
+        minutes: shifted.getUTCHours() * 60 + shifted.getUTCMinutes(),
+    };
+}
+function beijingInstant(year, month, day, minutes) {
+    return new Date(Date.UTC(year, month - 1, day, 0, minutes - BEIJING_OFFSET_MINUTES));
+}
+export function isCnPublicHoliday(date) {
+    const parts = beijingParts(date);
+    const key = `${String(parts.month).padStart(2, "0")}-${String(parts.day).padStart(2, "0")}`;
+    return CN_PUBLIC_HOLIDAYS[parts.year]?.has(key) ?? false;
+}
+function tierAt(rule, date) {
+    const parts = beijingParts(date);
+    if (parts.weekday === 0 || parts.weekday === 6) {
+        return "off_peak";
+    }
+    if (rule.excludePublicHolidays && isCnPublicHoliday(date)) {
+        return "off_peak";
+    }
+    const inPeak = rule.peakSegments.some(([start, end]) => parts.minutes >= start && parts.minutes < end);
+    return inPeak ? "peak" : "off_peak";
+}
+// The tier can only flip at a segment edge or at midnight, so walking those
+// instants day by day finds the next change without minute-level scanning.
+function nextTierChange(rule, date) {
+    const current = tierAt(rule, date);
+    const start = beijingParts(date);
+    const edges = Array.from(new Set([0, ...rule.peakSegments.flatMap(([a, b]) => [a, b])]))
+        .filter((m) => m < MINUTES_PER_DAY)
+        .sort((a, b) => a - b);
+    for (let offset = 0; offset <= LOOKAHEAD_DAYS; offset += 1) {
+        for (const edge of edges) {
+            const candidate = beijingInstant(start.year, start.month, start.day + offset, edge);
+            if (candidate.getTime() <= date.getTime()) {
+                continue;
+            }
+            if (tierAt(rule, candidate) !== current) {
+                return candidate;
+            }
+        }
+    }
+    // Unreachable with the rules above (every week has weekdays); keep a sane bound.
+    return beijingInstant(start.year, start.month, start.day + LOOKAHEAD_DAYS, 0);
+}
+function pricingFor(rule, date) {
+    const tier = tierAt(rule, date);
+    return {
+        tier,
+        discountPercent: tier === "off_peak" ? rule.offPeakDiscountPercent : 0,
+        until: nextTierChange(rule, date).toISOString(),
+        timezone: "Asia/Shanghai",
+        rule: rule.rule,
+    };
+}
+export function deepseekPricing(now = new Date()) {
+    return pricingFor(DEEPSEEK_RULE, now);
+}
+export function glmPricing(now = new Date()) {
+    return pricingFor(GLM_RULE, now);
+}
+export function pricingLabel(pricing, until) {
+    return pricing.tier === "off_peak"
+        ? `Off-peak · ${pricing.discountPercent}% off until ${until}`
+        : `Peak · full price until ${until}`;
+}

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

@@ -8,11 +8,20 @@ export interface UsageWindow {
     usedPercent: number;
     resetsAt: string;
 }
+export interface PricingInfo {
+    tier: "peak" | "off_peak";
+    discountPercent: number;
+    until: string;
+    timezone: string;
+    rule: string;
+}
 export interface ProviderUsage {
     provider: ProviderId;
     source: string;
     observedAt: string;
     planType?: string | null;
+    quotaUnit?: "tokens" | "credits";
+    pricing?: PricingInfo;
     windows: UsageWindow[];
     balance?: {
         total: string;
@@ -96,11 +105,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.6.0",
   "description": "macOS menu bar usage monitor for Claude Code, Codex, GLM, DeepSeek, and MiniMax.",
   "author": "hanzhangzzz",
   "license": "MIT",