pi-minimal-footer 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-10-28
+
+### Added
+
+- Optional percentage context display, e.g. `24.7%/500k`, enabled with `minFooter.contextAsPercentage`
+
+### Changed
+
+- Clearer default context counts, e.g. `0.78k/500k`, `1.0k/500k`, and `124k/500k`, with explicit units on both values
+
 ## [0.7.1] - 2026-10-16
 
 ### Fixed
@@ -263,7 +273,8 @@ First npm-ready release.
 
 - Project scaffold — `extensions/index.ts` with basic footer structure, `package.json` with pi extension manifest, `README.md`, `LICENSE` (MIT)
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.7.1...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.3...v0.6.0

package/README.md

@@ -9,7 +9,7 @@
 
 An opinionated, compact, one-line status bar for [Pi](https://github.com/earendil-works/pi).
 
-![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · [⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h](media/preview.png)
+![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42k/200k · [⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h](media/preview.png)
 
 **Left**
 
@@ -20,7 +20,7 @@ An opinionated, compact, one-line status bar for [Pi](https://github.com/earendi
 
 - Extension statuses: ` 🧠 Karpathy  🪽 Icarus`
 - Model: `model`
-- Context usage: `42/200k`
+- Context usage: `42k/200k` (default), or `21.0%/200k` with `contextAsPercentage: true`
 - Subscription usage bar with reset time: `[⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h`
 
 ## Install
@@ -58,6 +58,7 @@ Edit `minFooter` in Pi's agent `settings.json` (normally `~/.pi/agent/settings.j
     "showPath": true,
     "showModel": true,
     "showContext": true,
+    "contextAsPercentage": false,
     "powerlineSeparator": true,
     "gitRefreshSeconds": 91,
     "gitFetch": false,
@@ -82,7 +83,7 @@ Counts require a configured upstream. Unsynced branches use normal text color; s
 
 ### Context
 
-`42/200k` means tokens used / context window. `?` means Pi has not reported usage yet, including immediately after compaction.
+`42k/200k` means tokens used / context window. Set `"contextAsPercentage": true` under `minFooter` to show `21.0%/200k` instead. Unknown usage shows `?`.
 
 ### Subscription usage
 

package/VISION.md

@@ -36,6 +36,13 @@ Two cells give 6.25% steps; ten give 1.25%. Fill rounds to the nearest eighth-ce
 
 The bar and reset label have no intervening space. Reset formatting uses local clock time through 24 hours, remaining whole days/hours above 24 hours, and whole days above 10 days. Exactly 24 hours stays clock time; exactly 10 days is `↻10d0h`. Missing reset metadata leaves the bar visible without a label.
 
+## Context display contract
+
+- Default to tokens used / context window, with an explicit `k` suffix on both values. Never deduplicate units across the slash.
+- Always use kilos, including for million-token windows (`1000k`, not `1M`). Below 10k, use two significant digits where one-token resolution permits, capped at three decimal places in kilos: `0.001k`, `0.012k`, `0.11k`, `0.78k`, `0.99k`, `1.0k`, `9.0k`. At and above 10k, round to whole kilos: `10k`, `124k`, `1000k`. Zero is `0k`; rounding can promote `9.999k` to `10k`.
+- `minFooter.contextAsPercentage` defaults to `false`. Opting in replaces only the numerator with percentage used to one decimal place, e.g. `24.7%/500k`. Keep context distinct from the subscription usage bar.
+- Unknown token usage is `?/500k` in either mode; absent context usage is `?`. Never present unknown usage as zero.
+
 ## Git contract
 
 - Pi supplies the branch name. Query `git rev-list --left-right --count HEAD...@{upstream}` for `↑N` local-only and `↓N` upstream-only commits. Use local refs; no remote fetch by default.

package/extensions/index.ts

@@ -1,7 +1,7 @@
 /**
  * Minimal footer — replaces pi's default footer with a clean status line:
  *
- *   ~/path/to/dir   main        status1  status2  sonnet · 12/128k · [⣿⣶⠀⠀⠀]↻16:40
+ *   ~/path/to/dir   main        status1  status2  sonnet · 12k/128k · [⣿⣶⠀⠀⠀]↻16:40
  *
  * Settings are persisted in the agent directory (usually ~/.pi/agent)
  * settings.json under "minFooter".
@@ -31,6 +31,7 @@ interface Settings {
     showPath?: boolean;
     showModel?: boolean;
     showContext?: boolean;
+    contextAsPercentage?: boolean;
     powerlineSeparator?: boolean;
     gitRefreshSeconds?: number;
     gitFetch?: boolean;
@@ -52,6 +53,7 @@ const DEFAULT_SETTINGS: FooterSettings = {
   showPath: true,
   showModel: true,
   showContext: true,
+  contextAsPercentage: false,
   powerlineSeparator: true,
   gitRefreshSeconds: 91,
   gitFetch: false,
@@ -111,9 +113,11 @@ function writeEnabled(v: boolean): void {
 
 function formatSize(n: number | null | undefined): string {
   if (n == null) return "?";
-  if (n >= 1_000_000) return `${Math.round(n / 1_000_000)}M`;
-  if (n >= 1_000) return `${Math.round(n / 1_000)}k`;
-  return String(n);
+  const kilos = n / 1_000;
+  if (n === 0 || n >= 10_000) return `${Math.round(kilos)}k`;
+  const rounded = Number(kilos.toPrecision(2));
+  const decimals = Math.min(3, Math.max(0, 1 - Math.floor(Math.log10(rounded))));
+  return `${rounded.toFixed(decimals)}k`;
 }
 
 /** Abbreviate only an exact home match or a boundary-prefixed child path. */
@@ -166,7 +170,7 @@ async function updateGitSync(state: FooterState): Promise<boolean> {
   return changed;
 }
 
-function updateState(ctx: ExtensionContext, state: FooterState): void {
+function updateState(ctx: ExtensionContext, state: FooterState, config: FooterSettings): void {
   const cwd = ctx.cwd ?? process.cwd();
   if (state.cwd !== cwd) {
     state.gitSync = "";
@@ -177,16 +181,11 @@ function updateState(ctx: ExtensionContext, state: FooterState): void {
   state.model = ctx.model?.id ?? "no-model";
   const usage = ctx.getContextUsage();
   if (usage) {
-    const fTokens = formatSize(usage.tokens);
+    const fTokens = config.contextAsPercentage === true
+      ? (usage.tokens == null || usage.contextWindow <= 0 ? "?" : `${(usage.tokens / usage.contextWindow * 100).toFixed(1)}%`)
+      : formatSize(usage.tokens);
     const fWindow = formatSize(usage.contextWindow);
-    const lastT = fTokens[fTokens.length - 1];
-    const lastW = fWindow[fWindow.length - 1];
-    // Deduplicate k/M suffix: show suffix only on denominator when both use the same unit
-    if ((lastT === "k" || lastT === "M") && lastT === lastW) {
-      state.context = `${fTokens.slice(0, -1)}/${fWindow}`;
-    } else {
-      state.context = `${fTokens}/${fWindow}`;
-    }
+    state.context = `${fTokens}/${fWindow}`;
   } else {
     state.context = "?";
   }
@@ -420,7 +419,7 @@ export default function (pi: ExtensionAPI) {
   }
 
   function refresh(ctx: ExtensionContext): void {
-    updateState(ctx, state);
+    updateState(ctx, state, config);
     refreshFooter();
   }
 
@@ -431,7 +430,7 @@ export default function (pi: ExtensionAPI) {
         !("enabled" in data) || typeof data.enabled !== "boolean") return;
     if (enabled === data.enabled && (!enabled || disposeFooter !== null)) return;
     enabled = data.enabled;
-    updateState(currentCtx, state);
+    updateState(currentCtx, state, config);
     install(currentCtx);
     refreshFooter();
   });
@@ -440,7 +439,7 @@ export default function (pi: ExtensionAPI) {
     currentCtx = ctx;
     enabled = readConfig().enabled !== false;
     usageLimits.stop();
-    updateState(ctx, state);
+    updateState(ctx, state, config);
     install(ctx);
     refreshFooter();
   });
@@ -493,7 +492,7 @@ export default function (pi: ExtensionAPI) {
       else if (args === "off") enabled = false;
       else enabled = !enabled;
       writeEnabled(enabled);
-      updateState(ctx, state);
+      updateState(ctx, state, config);
       install(ctx);
       refreshFooter();
       ctx.ui.notify(`Minimal footer ${enabled ? "enabled" : "disabled"}`, "info");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "An opinionated minimal Pi footer - one-line status bar showing subscription usage, path, status, model and context.",
   "keywords": [
     "footer",