coding-usage-bar 0.1.0 → 0.2.0

package/README.md

@@ -2,18 +2,26 @@
 
 [English](README.md) · [简体中文](README.zh-CN.md)
 
-**Claude Code and Codex usage monitoring in your macOS menu bar.** Track rolling plan limits across Claude Code, OpenAI Codex, GLM (Zhipu AI), DeepSeek, and MiniMax before a coding session hits the wall.
+**Claude Code and Codex usage monitoring in your macOS menu bar.** Track rolling plan limits across Claude Code, OpenAI Codex, GLM (Zhipu AI), DeepSeek, MiniMax, and Kimi (Moonshot AI) before a coding session hits the wall.
 
 [![npm](https://img.shields.io/npm/v/coding-usage-bar.svg)](https://www.npmjs.com/package/coding-usage-bar)
 [![CI](https://github.com/hanzhangzzz/coding-usage-bar/actions/workflows/test.yml/badge.svg)](https://github.com/hanzhangzzz/coding-usage-bar/actions/workflows/test.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![platform](https://img.shields.io/badge/platform-macOS-lightgrey.svg?logo=apple)](#requirements)
 
-![Coding Usage Bar showing Claude Code, Codex, GLM, DeepSeek, and MiniMax plan usage in the macOS menu bar](docs/assets/hero.png)
+![Coding Usage Bar showing Claude Code, Codex, GLM, DeepSeek, MiniMax, and Kimi plan usage in the macOS menu bar](docs/assets/hero.png)
 
 Coding Usage Bar does more than display quota percentages. It compares short rolling windows with the weekly budget and labels your pace as learning, under-burning, on track, over-burning, or close to a limit.
 
-Claude Code and Codex data stays local and is read from files those tools already produce. Provider API keys for GLM, DeepSeek, and MiniMax are stored only in `~/.coding-usage-bar/config.json` and sent directly to their respective quota APIs.
+Claude Code and Codex data stays local and is read from files those tools already produce. Provider API keys for GLM, DeepSeek, and MiniMax are stored only in `~/.coding-usage-bar/config.json` and sent directly to their respective quota APIs. Kimi reads its key from `~/.coding-usage-bar/config.json` or, when unset, from the kimi.com lane in `~/.config/claude-lanes/config.env`.
+
+## 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.
+
+<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">
+</p>
 
 ## Quick Start
 
@@ -119,6 +127,21 @@ Coding Usage Bar calls `GET https://api.minimaxi.com/v1/token_plan/remains` to r
 
 `region` defaults to `cn` (api.minimaxi.com); set it to `global` to use api.minimax.io. Without this key, MiniMax monitoring will report `MINIMAX_API_KEY_MISSING`.
 
+## Kimi (Moonshot AI)
+
+Coding Usage Bar calls `GET https://api.kimi.com/coding/v1/usages` to read 5h and 7d usage windows. The response carries the 300-minute rolling window in `limits[]` and the weekly window in the top-level `usage`, with `limit`/`used`/`remaining` as strings; Coding Usage Bar derives used% from `used / limit` (or from `used / (used + remaining)` when limit is 0). Set `kimi.apiKey` in `~/.coding-usage-bar/config.json`:
+
+```json
+{
+  "providers": ["codex", "claude", "glm", "minimax", "kimi"],
+  "kimi": {
+    "apiKey": "your-kimi-api-key"
+  }
+}
+```
+
+If `kimi.apiKey` is empty, Coding Usage Bar falls back to the lane whose `CONFIG_<n>_BASE_URL` points at kimi.com in `~/.config/claude-lanes/config.env` and uses that lane's `CONFIG_<n>_AUTH_TOKEN` (and base URL). Without either source, Kimi monitoring will report `KIMI_API_KEY_MISSING`.
+
 ## Profiles
 
 Set `CODING_USAGE_BAR_PROFILE=high` for the more aggressive profile. The default is `low`.
@@ -135,7 +158,7 @@ Both profiles are constrained by the weekly budget. When a short window is repor
 
 ```json
 {
-  "providers": ["codex", "claude", "glm", "deepseek", "minimax"]
+  "providers": ["codex", "claude", "glm", "deepseek", "minimax", "kimi"]
 }
 ```
 
@@ -153,7 +176,7 @@ coding-usage-bar menubar install
 
 If SwiftBar is not installed, `coding-usage-bar doctor` will report it. If SwiftBar already has a custom plugin folder, Coding Usage Bar uses that folder.
 
-The compact menu bar title and dropdown use recognizable Provider marks for Codex, Claude Code, Zhipu AI, DeepSeek, and MiniMax alongside the rolling-window data (DeepSeek shows balance instead of windows):
+The compact menu bar title and dropdown use recognizable Provider marks for Codex, Claude Code, Zhipu AI, DeepSeek, MiniMax, and Kimi alongside the rolling-window data (DeepSeek shows balance instead of windows):
 
 ```text
 {Codex icon} 5H:14%,7D:67% │ {Claude icon} 5H:24%,7D:74% │ {GLM icon} 5H:36%,7D:7%
@@ -166,13 +189,14 @@ SwiftBar only supports one bitmap image on a single stable title item, so Coding
 | Path | Purpose |
 |------|---------|
 | `~/.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"]` |
+| `~/.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/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 |
 | `~/.coding-usage-bar/deepseek/latest.json` | Latest normalized DeepSeek balance from DeepSeek API |
 | `~/.coding-usage-bar/minimax/latest.json` | Latest normalized MiniMax 5h/7d usage from MiniMax API |
+| `~/.coding-usage-bar/kimi/latest.json` | Latest normalized Kimi 5h/7d usage from Kimi usages API |
 | `~/.local/bin/coding-usage-bar` | CLI shim pointing at the stable runtime |
 | `~/Library/LaunchAgents/com.duying.coding-usage-bar.plist` | macOS launchd agent |
 | SwiftBar `PluginDirectory` / `coding-usage-bar.1m.js` | Menu bar plugin wrapper |
@@ -191,7 +215,7 @@ See the [product and technical baseline](https://github.com/hanzhangzzz/coding-u
 
 ## Why Coding Usage Bar?
 
-- **One menu bar for multiple coding providers:** Claude Code, Codex, GLM, DeepSeek, and MiniMax.
+- **One menu bar for multiple coding providers:** Claude Code, Codex, GLM, DeepSeek, MiniMax, and Kimi.
 - **Pacing, not just percentages:** short-window usage is evaluated against the weekly budget.
 - **Local-first:** Claude Code and Codex usage is read from local tool output, without a separate account or telemetry service.
 - **Visible but lightweight:** SwiftBar is only the host; collection and display state remain separated and auditable.
@@ -217,4 +241,4 @@ npm pack
 
 [MIT](LICENSE)
 
-Provider names and trademarks belong to their respective owners. Coding Usage Bar is an independent project and is not affiliated with or endorsed by Anthropic, OpenAI, Zhipu AI, DeepSeek, or MiniMax. Provider marks are used only for identification, are excluded from the MIT License, and are documented in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+Provider names and trademarks belong to their respective owners. Coding Usage Bar is an independent project and is not affiliated with or endorsed by Anthropic, OpenAI, Zhipu AI, DeepSeek, MiniMax, or Moonshot AI. Provider marks are used only for identification, are excluded from the MIT License, and are documented in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/README.zh-CN.md

@@ -6,9 +6,17 @@
 
 ![Coding Usage Bar 在 macOS 菜单栏展示多个 AI 编程 Provider 的套餐用量](docs/assets/hero.png)
 
-Coding Usage Bar 同时支持 Claude Code、OpenAI Codex、GLM（智谱 AI）、DeepSeek 和 MiniMax。它不只展示百分比，还会结合短周期和周额度判断当前节奏是偏慢、正常、偏快，还是已经接近限额。
+Coding Usage Bar 同时支持 Claude Code、OpenAI Codex、GLM（智谱 AI）、DeepSeek、MiniMax 和 Kimi（Moonshot AI）。它不只展示百分比，还会结合短周期和周额度判断当前节奏是偏慢、正常、偏快，还是已经接近限额。
 
-Claude Code 与 Codex 的数据直接读取它们在本机产生的文件，不需要额外登录，也不会上传使用记录。GLM、DeepSeek 和 MiniMax 的 API Key 只保存在 `~/.coding-usage-bar/config.json`，并直接请求对应 Provider 的额度接口。
+Claude Code 与 Codex 的数据直接读取它们在本机产生的文件，不需要额外登录，也不会上传使用记录。GLM、DeepSeek 和 MiniMax 的 API Key 只保存在 `~/.coding-usage-bar/config.json`，并直接请求对应 Provider 的额度接口。Kimi 的 Key 优先读 `~/.coding-usage-bar/config.json`，未配置时回退到 `~/.config/claude-lanes/config.env` 中指向 kimi.com 的 lane。
+
+## 真实 SwiftBar 菜单
+
+以下截图来自正在运行的 SwiftBar 插件；动画复现菜单的展开与收起，不修改截图中的用量数据。
+
+<p align="center">
+  <img src="docs/assets/demo.gif" alt="打开 Coding Usage Bar 的真实 SwiftBar 菜单，查看 Codex、Claude、GLM、DeepSeek、MiniMax 和 Kimi 用量" width="800">
+</p>
 
 ## 快速开始
 
@@ -50,4 +58,4 @@ npm pack
 
 [MIT](LICENSE)
 
-各 Provider 名称与商标归其权利人所有。本项目独立开发，与 Anthropic、OpenAI、智谱 AI、DeepSeek、MiniMax 无隶属或背书关系。Provider 标识仅用于识别，不适用项目 MIT License，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+各 Provider 名称与商标归其权利人所有。本项目独立开发，与 Anthropic、OpenAI、智谱 AI、DeepSeek、MiniMax、Moonshot AI 无隶属或背书关系。Provider 标识仅用于识别，不适用项目 MIT License，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -9,6 +9,7 @@ Coding Usage Bar includes the following provider marks solely to identify the se
 | `assets/provider-glm.png`, `assets/provider-glm-dark.png` | Zhipu AI / GLM |
 | `assets/provider-deepseek.png` | DeepSeek |
 | `assets/provider-minimax.png` | MiniMax |
+| `assets/provider-kimi.png` | Moonshot AI / Kimi |
 | `assets/provider-marks.png` | Composite of the marks listed above |
 
 These marks and their associated names are owned by their respective holders. They are **not** licensed under this repository's MIT License. Their inclusion identifies the Provider whose usage is displayed and does not imply affiliation, sponsorship, or endorsement. No rights to the marks are granted by this project. Use of a mark remains subject to its owner's applicable brand rules, including the [OpenAI Design Guidelines](https://openai.com/brand/).

package/dist/burn.js

@@ -56,7 +56,7 @@ export function estimateConversionRate(samples) {
     return Number.isFinite(value) && value > 0 ? value : null;
 }
 function providerLabel(provider) {
-    return provider === "claude" ? "Claude" : provider === "glm" ? "GLM" : provider === "deepseek" ? "DeepSeek" : provider === "minimax" ? "MiniMax" : "Codex";
+    return provider === "claude" ? "Claude" : provider === "glm" ? "GLM" : provider === "deepseek" ? "DeepSeek" : provider === "minimax" ? "MiniMax" : provider === "kimi" ? "Kimi" : "Codex";
 }
 function messageForState(provider, state, fiveUsed, target) {
     const label = providerLabel(provider);

package/dist/claude.js

@@ -114,22 +114,122 @@ function statusLineScriptCandidates(command) {
     }
     return [...new Set(candidates)];
 }
+function stripInlineShellComment(line) {
+    let quote = null;
+    let escaped = false;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if ((char === "'" || char === "\"") && !quote) {
+            quote = char;
+            continue;
+        }
+        if (char === quote) {
+            quote = null;
+            continue;
+        }
+        if (char === "#" && !quote && (index === 0 || /\s/.test(line[index - 1]))) {
+            return line.slice(0, index);
+        }
+    }
+    return line;
+}
+function hasBalancedShellQuotes(line) {
+    let quote = null;
+    let escaped = false;
+    for (const char of line) {
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if ((char === "'" || char === "\"") && !quote) {
+            quote = char;
+        }
+        else if (char === quote) {
+            quote = null;
+        }
+    }
+    return quote === null;
+}
+function executableShellLines(text) {
+    const result = [];
+    const heredocDelimiters = [];
+    for (const rawLine of text.replace(/\\\r?\n/g, " ").split(/\r?\n/)) {
+        if (heredocDelimiters.length > 0) {
+            if (rawLine.trim() === heredocDelimiters[0]) {
+                heredocDelimiters.shift();
+            }
+            continue;
+        }
+        const line = stripInlineShellComment(rawLine);
+        const heredocPattern = /<<-?\s*(?:'([^']+)'|"([^"]+)"|\\([^\s;|&()<>]+)|([^\s;|&()<>]+))/g;
+        const heredocs = [...line.matchAll(heredocPattern)];
+        if (heredocs.length > 0) {
+            for (const heredoc of heredocs) {
+                heredocDelimiters.push(heredoc[1] ?? heredoc[2] ?? heredoc[3] ?? heredoc[4]);
+            }
+            result.push(line.slice(0, heredocs[0].index));
+        }
+        else {
+            result.push(line);
+        }
+    }
+    return result;
+}
 export function claudeStatusLineHasIngest(command, options) {
+    const isCliPath = (word) => (path.basename(word) === "coding-usage-bar"
+        || word === options.appCliPath
+        || word.endsWith("/.coding-usage-bar/app/dist/cli.js"));
+    const hasIngestCommand = (text) => {
+        const lines = executableShellLines(text);
+        if (lines.some((line) => !hasBalancedShellQuotes(line))) {
+            return false;
+        }
+        return lines.some((line) => {
+            if (!line.trim()) {
+                return false;
+            }
+            const words = splitShellWords(line);
+            const commandStarts = [0, ...words.flatMap((word, index) => word === "|" ? [index + 1] : [])];
+            return commandStarts.some((start) => {
+                const executable = words[start];
+                const executableIsNode = ["node", "nodejs"].includes(path.basename(executable ?? ""));
+                const cliIndex = executableIsNode ? start + 1 : start;
+                const finalArgument = words[cliIndex + 2]?.replace(/[;)]$/, "");
+                return isCliPath(words[cliIndex] ?? "")
+                    && words[cliIndex + 1] === "ingest"
+                    && finalArgument === "claude-statusline";
+            });
+        });
+    };
     if (!command) {
         return false;
     }
-    if (command.includes("coding-usage-bar ingest claude-statusline")
-        || command.includes(options.appCliPath)
+    if (hasIngestCommand(command)
         || command === options.managedScriptPath) {
         return true;
     }
     for (const candidate of statusLineScriptCandidates(command)) {
         try {
+            if (isCliPath(candidate)) {
+                continue;
+            }
             if (!fs.statSync(candidate).isFile()) {
                 continue;
             }
             const script = fs.readFileSync(candidate, "utf8");
-            if (script.includes("coding-usage-bar ingest claude-statusline") || script.includes(options.appCliPath)) {
+            if (hasIngestCommand(script)) {
                 return true;
             }
         }

package/dist/config.js

@@ -1,7 +1,7 @@
 import { readJsonFile, writeJsonAtomic } from "./fs-util.js";
 import { buildPaths } from "./paths.js";
-const DEFAULT_PROVIDERS = ["codex", "claude", "glm", "deepseek", "minimax"];
-const PROVIDERS = new Set(["codex", "claude", "glm", "deepseek", "minimax"]);
+const DEFAULT_PROVIDERS = ["codex", "claude", "glm", "deepseek", "minimax", "kimi"];
+const PROVIDERS = new Set(["codex", "claude", "glm", "deepseek", "minimax", "kimi"]);
 function normalizeProviders(value) {
     if (!Array.isArray(value)) {
         return DEFAULT_PROVIDERS;
@@ -24,6 +24,7 @@ export function defaultConfig() {
         glm: { baseUrl: "https://open.bigmodel.cn", apiKey: "" },
         deepseek: { apiKey: "" },
         minimax: { region: "cn", apiKey: "" },
+        kimi: { apiKey: "" },
     };
 }
 export function readConfig(paths = buildPaths()) {
@@ -40,6 +41,7 @@ export function readConfig(paths = buildPaths()) {
         glm: fileConfig.glm ?? defaultConfig().glm,
         deepseek: fileConfig.deepseek ?? defaultConfig().deepseek,
         minimax: fileConfig.minimax ?? defaultConfig().minimax,
+        kimi: fileConfig.kimi ?? defaultConfig().kimi,
     };
 }
 export function ensureConfig(paths = buildPaths()) {
@@ -60,5 +62,9 @@ export function ensureConfig(paths = buildPaths()) {
     if (!latest.minimax) {
         writeJsonAtomic(paths.configFile, { ...latest, minimax: defaultConfig().minimax });
     }
+    const current = readJsonFile(paths.configFile) ?? latest;
+    if (!current.kimi) {
+        writeJsonAtomic(paths.configFile, { ...current, kimi: defaultConfig().kimi });
+    }
     return false;
 }

package/dist/doctor.js

@@ -4,6 +4,7 @@ import { readConfig } from "./config.js";
 import { collectCodexUsage } from "./codex.js";
 import { claudeStatusLineHasIngest, getClaudeStatusLineCommand, readClaudeSettings } from "./claude.js";
 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, swiftBarPluginPath } from "./menubar.js";
@@ -184,6 +185,37 @@ export function runDoctor(options = {}) {
             message: "disabled by config",
         });
     }
+    if (monitored.has("kimi")) {
+        const kimiConfig = resolveKimiConfig(config.kimi, paths.homeDir);
+        const hasApiKey = Boolean(kimiConfig.apiKey);
+        const keySource = config.kimi?.apiKey
+            ? "coding-usage-bar config"
+            : "claude-lanes config.env";
+        checks.push({
+            name: "Kimi API key",
+            ok: hasApiKey,
+            message: hasApiKey
+                ? `configured (${keySource})`
+                : "not set; edit ~/.coding-usage-bar/config.json to set kimi.apiKey, or configure a kimi.com lane in ~/.config/claude-lanes/config.env",
+        });
+        const kimiLatest = providerLatestPath(paths, "kimi");
+        checks.push({
+            name: "Kimi usage cache",
+            ok: !hasApiKey || isFile(kimiLatest),
+            message: isFile(kimiLatest)
+                ? `found ${kimiLatest}`
+                : hasApiKey
+                    ? `missing ${kimiLatest}; run coding-usage-bar daemon --once to collect`
+                    : "skipped (API key not set)",
+        });
+    }
+    else {
+        checks.push({
+            name: "Kimi",
+            ok: true,
+            message: "disabled by config",
+        });
+    }
     const backend = notificationBackend();
     const notificationOk = backend !== "unsupported" && backend !== "burnt-toast";
     checks.push({

package/dist/format.d.ts

@@ -1,6 +1,6 @@
 import { BurnAnalysis, StatusIssue, ProviderUsage, UsageWindow, StatusSnapshot } from "./types.js";
 export declare function formatDurationUntil(iso: string, now?: Date): string;
-export declare function formatProviderLabel(provider: string): "Claude" | "GLM" | "DeepSeek" | "MiniMax" | "Codex";
+export declare function formatProviderLabel(provider: string): "Claude" | "GLM" | "DeepSeek" | "MiniMax" | "Kimi" | "Codex";
 export declare function formatWindowLabel(window: UsageWindow): "5h" | "7d";
 export declare function usageBar(usedPercent: number, width?: number): string;
 export declare function formatStatusRows(usages: ProviderUsage[], analyses: BurnAnalysis[]): string;

package/dist/format.js

@@ -23,6 +23,8 @@ function providerLabel(provider) {
         return "DeepSeek";
     if (provider === "minimax")
         return "MiniMax";
+    if (provider === "kimi")
+        return "Kimi";
     return "Codex";
 }
 export function formatProviderLabel(provider) {

package/dist/install.d.ts

@@ -21,5 +21,6 @@ export declare function install(options?: {
 }): string[];
 export declare function uninstall(options?: {
     dryRun?: boolean;
+    launchctlRunner?: LaunchctlRunner;
 }): string[];
 export {};

package/dist/install.js

@@ -382,7 +382,7 @@ export function uninstall(options = {}) {
             messages.push(`[dry-run] would unload and remove ${paths.launchAgentFile}`);
         }
         else {
-            stopLaunchAgent(paths.launchAgentFile);
+            stopLaunchAgent(paths.launchAgentFile, options.launchctlRunner);
             fs.rmSync(paths.launchAgentFile, { force: true });
             messages.push(`Removed launchd agent: ${paths.launchAgentFile}`);
         }

package/dist/kimi.d.ts

@@ -0,0 +1,32 @@
+import { KimiConfig, ProviderUsage } from "./types.js";
+interface KimiQuotaDetail {
+    limit?: string | number;
+    used?: string | number;
+    remaining?: string | number;
+    resetTime?: string;
+}
+interface KimiWindowLimit {
+    window?: {
+        duration?: number;
+        timeUnit?: string;
+    };
+    detail?: KimiQuotaDetail;
+}
+interface KimiUsagesResponse {
+    user?: {
+        membership?: {
+            level?: string;
+        };
+    };
+    usage?: KimiQuotaDetail;
+    limits?: KimiWindowLimit[];
+}
+export declare function fetchKimiUsages(config: KimiConfig): Promise<KimiUsagesResponse>;
+export declare function usageFromKimiUsages(usages: KimiUsagesResponse, options: {
+    observedAt?: string;
+    source: string;
+}): ProviderUsage | null;
+export declare function readClaudeLanesKimiConfig(configFile: string): KimiConfig | null;
+export declare function resolveKimiConfig(config: KimiConfig | undefined, homeDir?: string): KimiConfig;
+export declare function collectKimiUsage(config: KimiConfig): Promise<ProviderUsage>;
+export {};

package/dist/kimi.js

@@ -0,0 +1,148 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { makeProviderUsage, normalizeWindow } from "./usage.js";
+const DEFAULT_BASE_URL = "https://api.kimi.com/coding";
+const KIMI_HOST_PATTERN = /kimi\.com/;
+function asNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim() !== "") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+// Kimi reports limit/used/remaining per window. Prefer the used/limit ratio;
+// when limit is 0 or missing, derive the total from used + remaining instead of
+// falling back to 0% while a real signal exists.
+function percentFromDetail(detail) {
+    const limit = asNumber(detail.limit);
+    const used = asNumber(detail.used);
+    const remaining = asNumber(detail.remaining);
+    if (limit !== null && limit > 0 && used !== null) {
+        return Math.max(0, Math.min(100, (used / limit) * 100));
+    }
+    if (used !== null && remaining !== null && used + remaining > 0) {
+        return Math.max(0, Math.min(100, (used / (used + remaining)) * 100));
+    }
+    return null;
+}
+function fiveHourLimit(limits) {
+    const withWindow = limits.filter((entry) => typeof entry.window?.duration === "number");
+    const exact = withWindow.find((entry) => entry.window?.duration === 300 && entry.window?.timeUnit === "TIME_UNIT_MINUTE");
+    if (exact) {
+        return exact;
+    }
+    const sorted = [...withWindow].sort((left, right) => (left.window?.duration ?? Infinity) - (right.window?.duration ?? Infinity));
+    return sorted[0] ?? null;
+}
+export async function fetchKimiUsages(config) {
+    const baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const url = `${baseUrl}/v1/usages`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            "Authorization": `Bearer ${config.apiKey}`,
+            "Content-Type": "application/json",
+        },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        throw new Error(`Kimi usages API returned HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+export function usageFromKimiUsages(usages, options) {
+    const shortWindow = fiveHourLimit(usages.limits ?? []);
+    const fiveHourPercent = shortWindow?.detail ? percentFromDetail(shortWindow.detail) : null;
+    const fiveHourReset = shortWindow?.detail?.resetTime;
+    const sevenDayPercent = usages.usage ? percentFromDetail(usages.usage) : null;
+    const sevenDayReset = usages.usage?.resetTime;
+    if (fiveHourPercent === null || !fiveHourReset || sevenDayPercent === null || !sevenDayReset) {
+        return null;
+    }
+    const fiveHour = normalizeWindow("five_hour", {
+        used_percent: fiveHourPercent,
+        resets_at: fiveHourReset,
+    }, 300);
+    const sevenDay = normalizeWindow("seven_day", {
+        used_percent: sevenDayPercent,
+        resets_at: sevenDayReset,
+    }, 10080);
+    if (!fiveHour || !sevenDay) {
+        return null;
+    }
+    return makeProviderUsage({
+        provider: "kimi",
+        source: options.source,
+        observedAt: options.observedAt,
+        planType: usages.user?.membership?.level ?? null,
+        fiveHour,
+        sevenDay,
+    });
+}
+// Claude Code lanes keep the Kimi credential in ~/.config/claude-lanes/config.env
+// as CONFIG_<n>_BASE_URL / CONFIG_<n>_AUTH_TOKEN pairs. Scan every numbered entry
+// and pick the one whose base URL points at kimi.com, so lane reordering does not
+// break the lookup.
+export function readClaudeLanesKimiConfig(configFile) {
+    let content;
+    try {
+        content = fs.readFileSync(configFile, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const entries = new Map();
+    for (const line of content.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const eq = trimmed.indexOf("=");
+        if (eq <= 0) {
+            continue;
+        }
+        entries.set(trimmed.slice(0, eq).trim(), trimmed.slice(eq + 1).trim());
+    }
+    const indices = new Set();
+    for (const key of entries.keys()) {
+        const match = key.match(/^CONFIG_(\d+)_(?:BASE_URL|AUTH_TOKEN)$/);
+        if (match) {
+            indices.add(Number(match[1]));
+        }
+    }
+    for (const index of [...indices].sort((left, right) => left - right)) {
+        const baseUrl = entries.get(`CONFIG_${index}_BASE_URL`);
+        const apiKey = entries.get(`CONFIG_${index}_AUTH_TOKEN`);
+        if (baseUrl && apiKey && KIMI_HOST_PATTERN.test(baseUrl)) {
+            return { baseUrl, apiKey };
+        }
+    }
+    return null;
+}
+// Resolution order: explicit ~/.coding-usage-bar/config.json kimi.* wins;
+// otherwise fall back to the claude-lanes lane that targets kimi.com.
+export function resolveKimiConfig(config, homeDir = os.homedir()) {
+    const lanes = readClaudeLanesKimiConfig(path.join(homeDir, ".config", "claude-lanes", "config.env"));
+    return {
+        baseUrl: config?.baseUrl || lanes?.baseUrl,
+        apiKey: config?.apiKey || lanes?.apiKey,
+    };
+}
+export async function collectKimiUsage(config) {
+    if (!config.apiKey) {
+        throw new Error("Kimi API key not configured. Edit ~/.coding-usage-bar/config.json to set kimi.apiKey, or configure a kimi.com lane in ~/.config/claude-lanes/config.env.");
+    }
+    const baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const usages = await fetchKimiUsages(config);
+    const usage = usageFromKimiUsages(usages, {
+        source: `${baseUrl}/v1/usages`,
+    });
+    if (!usage) {
+        throw new Error("Kimi usages response did not contain expected 5h/7d quota data");
+    }
+    return usage;
+}

package/dist/menubar.js

@@ -23,6 +23,7 @@ const PROVIDER_ICON_ASSET = {
     glm: "provider-glm.png",
     deepseek: "provider-deepseek.png",
     minimax: "provider-minimax.png",
+    kimi: "provider-kimi.png",
 };
 const PROVIDER_ICON_DARK_ASSET = {
     glm: "provider-glm-dark.png",
@@ -33,6 +34,7 @@ const PROVIDER_ICON_FALLBACK = {
     glm: "cpu",
     deepseek: "bubble.left.and.bubble.right",
     minimax: "waveform.path.ecg",
+    kimi: "k.square.fill",
 };
 const TITLE_ICON_ASSET = "provider-marks.png";
 const ALERT_COLOR = "#D97757,#E8956E";
@@ -56,7 +58,7 @@ const STATE_PRIORITY = {
 const TEXT_COLOR = "#111827,#F9FAFB";
 const MUTED_COLOR = "#6B7280,#A1A1AA";
 const ROW_FONT = "Menlo";
-const TITLE_PROVIDER_ORDER = ["codex", "claude", "glm", "deepseek", "minimax"];
+const TITLE_PROVIDER_ORDER = ["codex", "claude", "glm", "deepseek", "minimax", "kimi"];
 const TITLE_SEPARATOR = "│";
 const METER_WIDTH = 12;
 const ASSET_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "assets");
@@ -615,6 +617,9 @@ function issueLabel(code) {
     if (code === "MINIMAX_API_KEY_MISSING") {
         return "MiniMax API key not set";
     }
+    if (code === "KIMI_API_KEY_MISSING") {
+        return "Kimi API key not set";
+    }
     if (code === "USAGE_STALE") {
         return "Usage data is stale";
     }

package/dist/notifier.js

@@ -53,7 +53,7 @@ export function markNotified(analysis, paths = buildPaths(), now = new Date()) {
     writeJsonAtomic(paths.notificationStateFile, state);
 }
 function notificationText(analysis) {
-    const provider = analysis.provider === "claude" ? "Claude" : analysis.provider === "glm" ? "GLM" : "Codex";
+    const provider = analysis.provider === "claude" ? "Claude" : analysis.provider === "glm" ? "GLM" : analysis.provider === "minimax" ? "MiniMax" : analysis.provider === "deepseek" ? "DeepSeek" : analysis.provider === "kimi" ? "Kimi" : "Codex";
     const suffix = analysis.fiveHour ? `剩 ${formatDurationUntil(analysis.fiveHour.resetsAt)} 重置。` : "";
     if (analysis.state === "UNDER_BURN") {
         return {

package/dist/paths.js

@@ -11,6 +11,7 @@ export function buildPaths(homeDir = os.homedir()) {
         glmDir: path.join(stateDir, "glm"),
         deepseekDir: path.join(stateDir, "deepseek"),
         minimaxDir: path.join(stateDir, "minimax"),
+        kimiDir: path.join(stateDir, "kimi"),
         notificationStateFile: path.join(stateDir, "notifications.json"),
         statusFile: path.join(stateDir, "status.json"),
         starPromptFile: path.join(stateDir, "star-prompt.json"),
@@ -33,6 +34,8 @@ function providerDir(paths, provider) {
         return paths.deepseekDir;
     if (provider === "minimax")
         return paths.minimaxDir;
+    if (provider === "kimi")
+        return paths.kimiDir;
     if (provider === "claude")
         return paths.claudeDir;
     return paths.codexDir;

package/dist/runtime.js

@@ -6,13 +6,14 @@ import { collectCodexUsage } from "./codex.js";
 import { readJsonFile } from "./fs-util.js";
 import { collectGlmUsage } from "./glm.js";
 import { collectDeepseekUsage } from "./deepseek.js";
+import { collectKimiUsage, resolveKimiConfig } from "./kimi.js";
 import { collectMinimaxUsage } from "./minimax.js";
 import { buildPaths } from "./paths.js";
 import { loadLatestUsage, saveUsage } from "./store.js";
 import { createStatusSnapshot, loadStatusSnapshot, refreshStatusSnapshotFreshness, saveStatusSnapshot, } from "./status.js";
 const FIXTURES_DIR = fileURLToPath(new URL("../fixtures", import.meta.url));
 export function loadFixtureUsages(fixturesDir) {
-    const providers = ["claude", "codex", "glm", "deepseek", "minimax"];
+    const providers = ["claude", "codex", "glm", "deepseek", "minimax", "kimi"];
     return providers
         .map((provider) => readJsonFile(path.join(fixturesDir, provider, "latest.json")))
         .filter((item) => item !== null);
@@ -181,6 +182,44 @@ export async function collectLocalState(options = {}) {
             }
         }
     }
+    if (monitored.has("kimi")) {
+        const kimiConfig = resolveKimiConfig(config.kimi, paths.homeDir);
+        if (!kimiConfig.apiKey) {
+            issues.push({
+                provider: "kimi",
+                severity: "warning",
+                code: "KIMI_API_KEY_MISSING",
+                message: "Kimi API key not configured. Edit ~/.coding-usage-bar/config.json to set kimi.apiKey, or configure a kimi.com lane in ~/.config/claude-lanes/config.env.",
+            });
+        }
+        else {
+            try {
+                const kimi = await collectKimiUsage(kimiConfig);
+                saveUsage(kimi, paths);
+                usages.push(kimi);
+            }
+            catch (error) {
+                const cached = loadLatestUsage("kimi", paths);
+                if (cached) {
+                    usages.push(cached);
+                    issues.push({
+                        provider: "kimi",
+                        severity: "warning",
+                        code: "KIMI_USING_CACHE",
+                        message: `Kimi live usage unavailable; using cached usage from ${cached.observedAt}. ${error instanceof Error ? error.message : String(error)}`,
+                    });
+                }
+                else {
+                    issues.push({
+                        provider: "kimi",
+                        severity: "error",
+                        code: "KIMI_USAGE_MISSING",
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        }
+    }
     return { usages, issues };
 }
 export async function collectLocalUsages(options = {}) {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type ProviderId = "claude" | "codex" | "glm" | "deepseek" | "minimax";
+export type ProviderId = "claude" | "codex" | "glm" | "deepseek" | "minimax" | "kimi";
 export type WindowName = "five_hour" | "seven_day";
 export type BurnProfile = "low" | "high";
 export type BurnState = "RAW" | "UNDER_BURN" | "ON_TRACK" | "OVER_BURN" | "LIMIT_RISK";
@@ -51,6 +51,10 @@ export interface MinimaxConfig {
     region?: "cn" | "global";
     apiKey?: string;
 }
+export interface KimiConfig {
+    baseUrl?: string;
+    apiKey?: string;
+}
 export interface RuntimePaths {
     homeDir: string;
     stateDir: string;
@@ -60,6 +64,7 @@ export interface RuntimePaths {
     glmDir: string;
     deepseekDir: string;
     minimaxDir: string;
+    kimiDir: string;
     notificationStateFile: string;
     statusFile: string;
     starPromptFile: string;
@@ -98,4 +103,5 @@ export interface BurnConfig {
     glm?: GlmConfig;
     deepseek?: DeepseekConfig;
     minimax?: MinimaxConfig;
+    kimi?: KimiConfig;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-usage-bar",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "macOS menu bar usage monitor for Claude Code, Codex, GLM, DeepSeek, and MiniMax.",
   "author": "hanzhangzzz",
   "license": "MIT",
@@ -33,6 +33,7 @@
   },
   "files": [
     "assets",
+    "docs/assets/demo.gif",
     "docs/assets/hero.png",
     "dist",
     "fixtures",