@ogulcancelik/pi-minimal-footer 0.1.5 → 0.1.7

package/README.md

@@ -8,21 +8,22 @@ Minimal footer for [pi](https://github.com/badlogic/pi-mono) that replaces the d
 
 ## Features
 
-- **Context gauge** — working directory, git branch, model, thinking level, and context window usage with token counts
+- **Context gauge** — optional working directory and git branch, model, thinking level, and context window usage with token counts
 - **Subscription usage bars** — rolling window quotas with reset timers for supported providers
 - **Auto-refresh** — fetches usage on startup and model switch, then every 5 minutes
 - **Git integration** — branch name, dirty state, ahead/behind counts
 
 ## Supported providers
 
-| Provider | What it shows |
-|----------|---------------|
-| Claude Max | 5h + weekly rolling windows |
-| OpenAI Codex | Primary + secondary rolling windows |
-| GitHub Copilot | Premium interactions + chat quotas |
-| Google Gemini | Pro + Flash remaining quotas |
-| MiniMax | 5h + weekly rolling windows (Token Plan / Coding Plan) |
-| MiniMax CN | Same as MiniMax, China endpoint |
+| Provider       | What it shows                                          |
+| -------------- | ------------------------------------------------------ |
+| Claude Max     | 5h + weekly rolling windows                            |
+| OpenAI Codex   | Primary + secondary rolling windows                    |
+| GitHub Copilot | Premium interactions + chat quotas                     |
+| Google Gemini  | Pro + Flash remaining quotas                           |
+| MiniMax        | 5h + weekly rolling windows (Token Plan / Coding Plan) |
+| MiniMax CN     | Same as MiniMax, China endpoint                        |
+| Kimi Coding    | 5h + weekly rolling windows (Plan)                     |
 
 ## Install
 
@@ -30,16 +31,29 @@ Minimal footer for [pi](https://github.com/badlogic/pi-mono) that replaces the d
 pi install npm:@ogulcancelik/pi-minimal-footer
 ```
 
+## Configuration
+
+Environment variables (all optional):
+
+| Variable                        | Description                                              | Default |
+| ------------------------------- | -------------------------------------------------------- | ------- |
+| `PI_MINIMAL_FOOTER_SHOW_CWD`    | Show current working directory in footer status line     | `1`     |
+| `PI_MINIMAL_FOOTER_SHOW_BRANCH` | Show git branch/dirty/ahead/behind in footer status line | `1`     |
+
+Accepted false values: `0`, `false`, `no`, `off` (case-insensitive).
+
 ## How it works
 
 The footer reads context usage from the last assistant message's token counts (free — comes with every LLM response). Subscription usage is fetched from each provider's dedicated quota API using your existing auth tokens from `~/.pi/agent/auth.json` or environment variables.
 
 Usage is fetched:
+
 - Once on startup
 - Immediately on model switch (Ctrl+P)
 - Every 5 minutes after that
 
 Git state is refreshed:
+
 - Once on startup
 - When pi reports a branch change
 - At the end of each turn

package/index.ts

@@ -42,6 +42,19 @@ interface GitCache {
 const USAGE_REFRESH_INTERVAL = 5 * 60_000; // 5 minutes
 const usageCache = new Map<string, UsageSnapshot>(); // keyed by provider
 
+// ============ Env Flags ============
+
+function parseBooleanEnv(value: string | undefined, fallback: boolean): boolean {
+  if (value === undefined) return fallback;
+
+  const normalized = value.trim().toLowerCase();
+  if (!normalized) return fallback;
+
+  if (["1", "true", "yes", "on"].includes(normalized)) return true;
+  if (["0", "false", "no", "off"].includes(normalized)) return false;
+  return fallback;
+}
+
 // ============ Identity Cache ============
 
 let codexEmailPrefix: string | null | undefined; // undefined = not yet resolved
@@ -250,6 +263,10 @@ function getMinimaxToken(provider: "minimax" | "minimax-cn"): string | undefined
     : getApiKey("minimax-cn", "MINIMAX_CN_API_KEY");
 }
 
+function getKimiToken(): string | undefined {
+  return getApiKey("kimi-coding", "KIMI_API_KEY");
+}
+
 // ============ Time Formatting ============
 
 function formatResetTime(date: Date): string {
@@ -614,6 +631,69 @@ async function fetchMinimaxUsage(provider: "minimax" | "minimax-cn"): Promise<Us
   }
 }
 
+async function fetchKimiUsage(): Promise<UsageSnapshot> {
+  const token = getKimiToken();
+  const endpoint = "https://api.kimi.com/coding/v1/usages";
+  if (!token) {
+    return { provider: "Kimi Coding", windows: [], error: "no-auth", fetchedAt: Date.now() };
+  }
+
+  try {
+    const res = await fetchWithTimeout(endpoint, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+    });
+
+    if (!res.ok) {
+      return { provider: "Kimi Coding", windows: [], error: `HTTP ${res.status}`, fetchedAt: Date.now() };
+    }
+
+    const data = (await res.json()) as any;
+    const windows: RateWindow[] = [];
+
+    for (const limit of data.limits || []) {
+      const windowLimit = Number(limit.detail?.limit) || 0;
+      const windowRemaining = Number(limit.detail?.remaining) || 0;
+      if (windowLimit > 0) {
+        const used = windowLimit - windowRemaining;
+        const usedPercent = clampPercent((used / windowLimit) * 100);
+        const resetDate = limit.detail?.resetTime ? new Date(limit.detail.resetTime) : undefined;
+        const durationMs =
+          limit.window?.duration && limit.window?.timeUnit === "TIME_UNIT_MINUTE"
+            ? limit.window.duration * 60 * 1000
+            : undefined;
+
+        windows.push({
+          label: getWindowLabel(durationMs, "5h"),
+          usedPercent,
+          resetsIn: resetDate ? formatResetTime(resetDate) : undefined,
+        });
+      }
+    }
+
+    const weeklyLimit = Number(data.usage?.limit) || 0;
+    const weeklyRemaining = Number(data.usage?.remaining) || 0;
+    const weeklyResetTime = data.usage?.resetTime;
+
+    if (weeklyLimit > 0) {
+      const used = weeklyLimit - weeklyRemaining;
+      const usedPercent = clampPercent((used / weeklyLimit) * 100);
+      windows.push({
+        label: "Weekly",
+        usedPercent,
+        resetsIn: weeklyResetTime ? formatResetTime(new Date(weeklyResetTime)) : undefined,
+      });
+    }
+
+    return { provider: "Kimi Coding", windows, fetchedAt: Date.now() };
+  } catch (e) {
+    return { provider: "Kimi Coding", windows: [], error: String(e), fetchedAt: Date.now() };
+  }
+}
+
 // ============ Provider Detection ============
 
 // Map pi provider names to our internal usage provider keys
@@ -624,6 +704,7 @@ const PROVIDER_MAP: Record<string, string> = {
   "google-gemini-cli": "gemini", // Gemini CLI subscription
   minimax: "minimax", // MiniMax Token Plan / Coding Plan
   "minimax-cn": "minimax-cn", // MiniMax China plan
+  "kimi-coding": "kimi-coding", // Kimi plan
 };
 
 function detectProvider(modelProvider: string): string | null {
@@ -644,6 +725,8 @@ async function fetchUsageForProvider(provider: string): Promise<UsageSnapshot> {
       return fetchMinimaxUsage("minimax");
     case "minimax-cn":
       return fetchMinimaxUsage("minimax-cn");
+    case "kimi-coding":
+      return fetchKimiUsage();
     default:
       return { provider: "Unknown", windows: [], error: "unknown-provider", fetchedAt: Date.now() };
   }
@@ -658,6 +741,10 @@ export default function (pi: ExtensionAPI) {
   const BAR_FILLED = "━";
   const BAR_EMPTY = "─";
 
+  // Optional visibility toggles (default: enabled)
+  const showCwd = parseBooleanEnv(process.env.PI_MINIMAL_FOOTER_SHOW_CWD, true);
+  const showBranch = parseBooleanEnv(process.env.PI_MINIMAL_FOOTER_SHOW_BRANCH, true);
+
   function formatTokenCount(tokens: number): string {
     if (tokens >= 1_000_000) {
       const m = tokens / 1_000_000;
@@ -814,7 +901,7 @@ export default function (pi: ExtensionAPI) {
   let latestUsage: UsageSnapshot | null = null;
   let activeProvider: string | null = null; // internal provider key for the current model
   let refreshTimer: ReturnType<typeof setInterval> | null = null;
-  
+
   // Store tui reference for triggering re-renders from event handlers
   let tuiRef: { requestRender: () => void } | null = null;
 
@@ -890,7 +977,7 @@ export default function (pi: ExtensionAPI) {
 
     ctx.ui.setFooter((tui: any, theme: any, footerData: any) => {
       tuiRef = tui;
-      
+
       const unsub = footerData.onBranchChange(() => {
         refreshGitFooter();
       });
@@ -920,7 +1007,7 @@ export default function (pi: ExtensionAPI) {
           }
 
           let branchStr = "";
-          if (gitCache?.branch) {
+          if (showBranch && gitCache?.branch) {
             const branchColor = gitCache.dirty ? "warning" : "success";
             branchStr = theme.fg(branchColor, gitCache.branch);
             if (gitCache.dirty) branchStr += theme.fg("warning", " *");
@@ -941,9 +1028,16 @@ export default function (pi: ExtensionAPI) {
 
           const sep = " " + theme.fg("dim", ">") + " ";
           const lines: string[] = [];
-          const pwdStr = theme.fg("accent", pwd);
+
+          const pwdStr = showCwd ? theme.fg("accent", pwd) : "";
+          const locationVariants: string[] = [];
+          if (pwdStr && branchStr) locationVariants.push(pwdStr + sep + branchStr);
+          if (pwdStr) locationVariants.push(pwdStr);
+          if (branchStr) locationVariants.push(branchStr);
+          const locationBlock = locationVariants.length > 0 ? fitFooterSegment(width, locationVariants) : "";
+
           const statusBlocks = [
-            fitFooterSegment(width, branchStr ? [pwdStr + sep + branchStr, pwdStr] : [pwdStr]),
+            locationBlock,
             fitFooterSegment(width, modelStr === plainModelStr ? [plainModelStr] : [modelStr, plainModelStr]),
             fitFooterSegment(width, [
               renderContextGauge(percentage, theme, ctxUsed, ctxTotal, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogulcancelik/pi-minimal-footer",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Minimal footer for pi with context gauge and subscription usage bars",
   "type": "module",
   "keywords": [