@llblab/pi-codex-usage 0.3.4 → 0.4.0

package/AGENTS.md

@@ -8,6 +8,6 @@
   - Trigger: Updating quota polling or error handling.
   - Action: Do not collapse the bar while a request is in flight; only show `n/a` or `error` after repeated failures or no usable quota.
 
-- `Compact dual bar`: Encode the 5-hour and weekly quota windows in the five-character separated-sextant bar.
+- `Compact dual bar`: Encode the 5-hour and weekly quota windows in the ten-character separated-sextant bar.
   - Trigger: Changing statusline formatting.
-  - Action: Keep a fixed-width `[xxxxx]` bar where top sextants represent the 5-hour window and bottom sextants represent the weekly window.
+  - Action: Keep a fixed-width `xxxxxxxxxx` bar where top sextants represent the 5-hour window and bottom sextants represent the weekly window, with 20 steps per window.

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+- `0.4.0` Expanded the dual statusline bar to ten glyphs with 20 steps per quota window, moved its status key near the start of the footer status order, and draws the bar on the themed selected background. Impact: 5-hour and weekly limits now move in 5% increments for 40 total discrete points while empty cells no longer blend into the terminal background.
+- `0.3.5` Refined the compact statusline bar with quadrant glyphs, darker bar coloring, and blink-on-segment-change behavior. Impact: Codex quota changes are easier to notice while routine refreshes stay visually stable.
 - `0.3.4` Added package banner metadata and README hero image. Impact: Pi/package listings can show the Codex Usage banner while npm packages include the image asset.
 - `Fork baseline` Imported `extensions/pi-codex-usage` from `narumiruna/pi-extensions` as a standalone `@llblab/pi-codex-usage` package. Impact: the extension can be installed and maintained independently.
 - `Minimal statusline` Removed command-driven report output and narrowed the extension to a zero-configuration statusline widget. Impact: runtime behavior is automatic while `openai-codex` is active.

package/README.md

@@ -15,12 +15,12 @@ This repository is a minimal fork of [`narumiruna/pi-extensions/extensions/pi-co
 ## Features
 
 - Shows an empty statusline bar immediately, then refreshes every 30 seconds while the active Pi model uses `openai-codex`
-- Statusline output stays compact, with the `codex` label accented and the values muted
+- Statusline output stays compact, with the `codex` label accented and the quota bar drawn on a themed background
 - Additional returned buckets, including Spark-specific limits, are ignored
 - Pi OpenAI Codex provider auth is used first
 - Codex CLI app-server remains available as a fallback
 - Missing auth, subscription, plan, or quota windows are shown as `n/a`, not as an error
-- Successful updates briefly redraw the bar without changing its width
+- Successful updates briefly redraw the bar only when a 5% segment changes
 - Network/provider failures keep the last good bar briefly, then show `error`
 - No commands or configuration are required
 
@@ -43,10 +43,10 @@ pi install git:github.com/llblab/pi-codex-usage
 Normal usage:
 
 ```text
-codex [𜺃𜺃𜹣𜹓𜹓]
+codex ██████▀▀▀▀
 ```
 
-The five-character bar encodes two ten-step limits at once: the top sextants are the 5-hour limit, and the bottom sextants are the weekly limit.
+The ten-character bar encodes two twenty-step limits at once: 40 total bits of quota state in 10 terminal cells. Each step is 5%: the top quadrants are the 5-hour limit, and the bottom quadrants are the weekly limit.
 
 Unavailable because Codex auth or subscription quota is not available:
 

package/index.ts

@@ -11,26 +11,26 @@ const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
 const DEFAULT_TIMEOUT_MS = 15_000;
 const REFRESH_INTERVAL_MS = 30 * 1000;
 const REDRAW_BLINK_MS = 150;
-const STATUS_KEY = "codex-usage";
+const STATUS_KEY = "aa-codex-usage";
 const MAX_ERROR_BODY_CHARS = 600;
 const STATUS_LABEL_TEXT = "codex";
 const DUAL_BAR_CHARS = [
   " ",
-  "𜹑",
-  "𜹒",
-  "𜹓",
-  "𜹠",
-  "𜹡",
-  "𜹢",
-  "𜹣",
-  "𜹰",
-  "𜹱",
-  "𜹲",
-  "𜹳",
-  "𜺀",
-  "𜺁",
-  "𜺂",
-  "𜺃",
+  "▘",
+  "▝",
+  "▀",
+  "▖",
+  "▌",
+  "▞",
+  "▛",
+  "▗",
+  "▚",
+  "▐",
+  "▜",
+  "▄",
+  "▙",
+  "▟",
+  "█",
 ];
 
 type UsageSource = "pi-auth" | "codex-app-server";
@@ -222,11 +222,15 @@ export default function codexUsage(pi: ExtensionAPI) {
       return;
     }
 
+    const previousReport = cache?.report;
+    const blink = previousReport
+      ? formatReportBar(previousReport) !== formatReportBar(result.report)
+      : false;
     failedRefreshes = 0;
     cache = { createdAt: Date.now(), report: result.report };
     setUsageStatusline(ctx, result.report, {
       autoRefresh: true,
-      blink: cache !== undefined,
+      blink,
       model,
     });
   };
@@ -684,24 +688,35 @@ export function formatCodexUsageStatusline(
   ctx: ExtensionContext,
   _model?: CodexUsageModel,
 ): string {
-  const snapshot = selectPrimaryCodexSnapshot(report);
-  if (!snapshot) return formatStatuslineText(ctx, "n/a");
+  const bar = formatReportBar(report);
+  return bar ? formatStatuslineBarText(ctx, bar) : formatStatuslineText(ctx, "n/a");
+}
 
-  if (!snapshot.primary && !snapshot.secondary)
-    return formatStatuslineText(ctx, "n/a");
-  return formatStatuslineText(
-    ctx,
-    `[${formatDualLimitBar(snapshot.primary, snapshot.secondary)}]`,
-  );
+function formatReportBar(report: CodexUsageReport): string | undefined {
+  const snapshot = selectPrimaryCodexSnapshot(report);
+  if (!snapshot || (!snapshot.primary && !snapshot.secondary)) return undefined;
+  return formatDualLimitBar(snapshot.primary, snapshot.secondary);
 }
 
 function formatStatuslineText(ctx: ExtensionContext, value: string): string {
   const label = ctx.ui.theme.fg("accent", STATUS_LABEL_TEXT);
-  return `${label} ${ctx.ui.theme.fg("muted", value)}`;
+  return `${label} ${ctx.ui.theme.fg("dim", value)}`;
+}
+
+function formatStatuslineBarText(ctx: ExtensionContext, bar: string): string {
+  const label = ctx.ui.theme.fg("accent", STATUS_LABEL_TEXT);
+  const value = ctx.ui.theme.bg(
+    "selectedBg",
+    ctx.ui.theme.fg("dim", bar),
+  );
+  return `${label} ${value}`;
 }
 
 function formatEmptyStatuslineBar(ctx: ExtensionContext): string {
-  return formatStatuslineText(ctx, "[\u00a0\u00a0\u00a0\u00a0\u00a0]");
+  return formatStatuslineBarText(
+    ctx,
+    "\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0",
+  );
 }
 
 function formatStatuslineProblem(
@@ -753,10 +768,10 @@ function formatDualLimitBar(
   primary: NormalizedRateLimitWindow | undefined,
   secondary: NormalizedRateLimitWindow | undefined,
 ): string {
-  const primaryParts = filledTenths(primary);
-  const secondaryParts = filledTenths(secondary);
+  const primaryParts = filledTwentieths(primary);
+  const secondaryParts = filledTwentieths(secondary);
   let value = "";
-  for (let index = 0; index < 5; index++) {
+  for (let index = 0; index < 10; index++) {
     const leftPart = index * 2 + 1;
     const rightPart = leftPart + 1;
     let mask = 0;
@@ -769,9 +784,9 @@ function formatDualLimitBar(
   return value;
 }
 
-function filledTenths(window: NormalizedRateLimitWindow | undefined): number {
+function filledTwentieths(window: NormalizedRateLimitWindow | undefined): number {
   if (!window) return 0;
-  return Math.round(remainingPercent(window) / 10);
+  return Math.round(remainingPercent(window) / 5);
 }
 
 function remainingPercent(window: NormalizedRateLimitWindow): number {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-codex-usage",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "private": false,
   "description": "Minimal Pi extension that shows primary Codex ChatGPT subscription usage limits.",
   "keywords": [