@cxmyu/ccglance 1.2.1 → 1.3.0

package/README.md

@@ -4,19 +4,31 @@
 
 **A fast, zero-dependency, multi-line status line for [Claude Code](https://docs.anthropic.com/en/docs/claude-code)**
 
-model · effort · context · cache · git · session — all at a glance
+model · effort · context · prompt cache · limits · git · session — all at a glance
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 [English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
-![ccglance preview](./docs/assets/preview.png)
+**Windows 11 · Segoe UI Emoji · Claude Code 2.1.258 sample**
+
+![ccglance on Windows 11](./docs/assets/preview-windows.png)
+
+**macOS · Apple Color Emoji · Claude Code 2.1.258 sample**
+
+![ccglance on macOS](./docs/assets/preview-macos.png)
 
 </div>
 
 > **stdin-first · zero runtime dependencies · fixed emoji style** — renders the JSON Claude Code pipes to its status-line command; only the `status` segment reads a bounded transcript tail. Written in TypeScript, shipped as compiled JavaScript; runs on Node.js ≥ 22 or Bun.
 
+Current Claude Code cache and usage-limit fields are covered, including the
+latest request's prompt-cache hit ratio and token traffic, warm/cold state, and
+the Hour, Week, and account Limit usage windows.
+Older Claude Code versions keep working through optional fields and the legacy
+cache calculation.
+
 **Docs:** [Overview](./docs/overview.md) · [Segments & icons](./docs/segments.md) · [Development](./docs/development.md)
 
 ## Terminal Font
@@ -29,7 +41,8 @@ ccglance intentionally outputs standard Unicode emoji. A Nerd Font improves text
 metrics and symbol coverage, but color emoji are still rendered by the operating
 system's emoji font (for example Segoe UI Emoji on Windows, Apple Color Emoji on
 macOS, and Noto Color Emoji on many Linux desktops), so their artwork can differ
-across platforms.
+across platforms. The two previews above use the same ccglance text, colors, and
+spacing; only the platform emoji font changes.
 
 ## Install
 

package/README.zh-CN.md

@@ -4,19 +4,29 @@
 
 **面向 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 的快速、零依赖多行状态栏**
 
-模型 · effort · 上下文 · 缓存 · git · 会话 —— 一眼尽览
+模型 · effort · 上下文 · prompt cache · 限额 · git · 会话 —— 一眼尽览
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 [English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
-![ccglance 预览](./docs/assets/preview.png)
+**Windows 11 · Segoe UI Emoji · Claude Code 2.1.258 示例**
+
+![ccglance 在 Windows 11 上的效果](./docs/assets/preview-windows.png)
+
+**macOS · Apple Color Emoji · Claude Code 2.1.258 示例**
+
+![ccglance 在 macOS 上的效果](./docs/assets/preview-macos.png)
 
 </div>
 
 > **stdin 优先 · 运行时零依赖 · 固定 emoji 风格** —— 渲染 Claude Code 经 stdin 传入的 JSON;仅 `status` 段读取 transcript 尾部固定字节。TypeScript 编写,以编译后的 JavaScript 发布,可在 Node.js ≥ 22 或 Bun 上运行。
 
+已覆盖新版 Claude Code 的缓存和限额字段，包括最近一次请求的 prompt cache 命中率与
+token 流量、缓存冷热状态，以及 Hour、Week 和账户 Limit 三类用量窗口。旧版 Claude Code 缺少这些可选字段时，
+仍会自动沿用原有缓存计算逻辑。
+
 **文档:** [概览](./docs/overview.zh-CN.md) · [字段与图标](./docs/segments.zh-CN.md) · [开发](./docs/development.zh-CN.md)
 
 ## 终端字体
@@ -28,6 +38,7 @@
 ccglance 会固定输出标准 Unicode emoji。Nerd Font 可以改善文本宽度和符号覆盖,
 但彩色 emoji 仍由系统 emoji 字体渲染(例如 Windows 的 Segoe UI Emoji、
 macOS 的 Apple Color Emoji、很多 Linux 桌面的 Noto Color Emoji),所以不同平台的图案可能不同。
+上面两张效果图使用完全相同的 ccglance 文本、颜色与间距,只有平台 emoji 字体不同。
 
 ## 安装
 

package/dist/cli.js

@@ -13,16 +13,24 @@ const PREVIEW_SAMPLE = {
         used_percentage: 23.5, remaining_percentage: 76.5,
         current_usage: { output_tokens: 1200, cache_read_input_tokens: 172000, cache_creation_input_tokens: 15000 },
     },
+    prompt_cache: {
+        warm: true, caching_observed: true, ttl: '1h',
+        expires_at: Math.floor(Date.now() / 1000) + 45 * 60,
+        requests: 14, misses: 2, expected_rebuilds: 1, hit_ratio: 0.91,
+        cache_write_tokens: 352000, miss_recache_tokens: 310200,
+        recache_tokens_if_cold: 45000,
+    },
     output_style: { name: 'default' },
     rate_limits: {
         five_hour: { used_percentage: 23.5, resets_at: Math.floor(Date.now() / 1000) + 2 * 3600 },
         seven_day: { used_percentage: 41.2, resets_at: Math.floor(Date.now() / 1000) + 3 * 86400 },
+        spend_limit: { used_percentage: 62.8, resets_at: Math.floor(Date.now() / 1000) + 30 * 86400 },
     },
     workspace: { current_dir: process.cwd() },
     worktree: { name: 'main', branch: 'main' },
     session_name: 'ccglance',
     cost: { total_cost_usd: 0.1234, total_duration_ms: 192000, total_lines_added: 156, total_lines_removed: 23 },
-    version: '2.1.221',
+    version: '2.1.258',
 };
 const argv = process.argv.slice(2);
 // 用法 + 「安装后要做什么」指引。终端直接运行或 --help 时打印；此路径绝不读 stdin。

package/dist/defaults/index.js

@@ -26,11 +26,11 @@ exports.DEFAULT_SPEC = {
         cache: { enabled: true },
         rate_limits: {
             enabled: true,
-            show: 'both',
+            show: 'all',
             warnPct: 70,
             dangerPct: 90,
             showReset: true,
-            labels: { five_hour: 'Hour', seven_day: 'Week' },
+            labels: { five_hour: 'Hour', seven_day: 'Week', spend_limit: 'Limit' },
         },
         style: { enabled: true },
         dir: { enabled: true, fullPath: false },

package/dist/segments/index.js

@@ -31,8 +31,22 @@ function positive(v) {
 function statusIcon(ctx, key, fallback) {
     return opt(ctx, 'status').statusIcons?.[key] || fallback;
 }
-function fmtRatePct(v) {
-    return Math.max(0, Math.min(100, Math.round(v))) + '%';
+function fmtRatePct(v, allowOver100 = false) {
+    const rounded = Math.max(0, Math.round(v));
+    return (allowOver100 ? rounded : Math.min(100, rounded)) + '%';
+}
+// Prompt-cache TTLs are short; minute precision stays compact and avoids a noisy seconds countdown.
+function fmtCacheRemaining(epochSec, nowMs) {
+    const expiry = num(epochSec);
+    if (expiry == null)
+        return null;
+    const ms = expiry * 1000 - nowMs;
+    if (ms <= 0)
+        return null;
+    const minutes = Math.max(1, Math.ceil(ms / 60000));
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return hours ? `${hours}h${rest ? `${rest}m` : ''}` : `${minutes}m`;
 }
 // 会话状态：读 transcript 尾部推断；默认仅显示图标，工具态附带工具名。
 const status = (ctx) => {
@@ -93,12 +107,34 @@ const cache = (ctx) => {
     const cw = ctx.data.context_window;
     if (!cw)
         return null;
-    const cu = cw.current_usage || {};
-    const used = nonNegative(cw.total_input_tokens) ?? nonNegative(cu.input_tokens) ?? 0;
-    const read = nonNegative(cu.cache_read_input_tokens) ?? 0;
-    const write = nonNegative(cu.cache_creation_input_tokens) ?? 0;
-    const hitPct = used > 0 && read > 0 ? read / used * 100 : 0;
-    return iconSeg(ctx, 'cache', colors_1.C.cache, 'cache', `${(0, format_1.fmtPct)(hitPct)}${colors_1.DOT}↓${(0, format_1.fmtTokens)(read)}${colors_1.DOT}↑${(0, format_1.fmtTokens)(write)}`);
+    const cu = cw.current_usage;
+    const read = nonNegative(cu?.cache_read_input_tokens) ?? 0;
+    const write = nonNegative(cu?.cache_creation_input_tokens) ?? 0;
+    const fresh = nonNegative(cu?.input_tokens);
+    const latestTotal = fresh != null
+        ? fresh + read + write
+        : nonNegative(cw.total_input_tokens);
+    const latestHitPct = cu && latestTotal != null
+        ? latestTotal > 0 ? Math.max(0, Math.min(100, read / latestTotal * 100)) : 0
+        : null;
+    const pc = ctx.data.prompt_cache;
+    const ratio = pc?.caching_observed === true ? num(pc.hit_ratio) : null;
+    const sessionHitPct = ratio != null ? Math.max(0, Math.min(1, ratio)) * 100 : null;
+    const parts = latestHitPct != null
+        ? [(0, format_1.fmtPct)(latestHitPct), `↓${(0, format_1.fmtTokens)(read)}`, `↑${(0, format_1.fmtTokens)(write)}`]
+        : sessionHitPct != null
+            ? [`Avg ${(0, format_1.fmtPct)(sessionHitPct)}`]
+            : ['0%', '↓0', '↑0'];
+    if (pc?.caching_observed === true && pc.warm === true) {
+        const remaining = fmtCacheRemaining(pc.expires_at, ctx.nowMs);
+        const ttl = typeof pc.ttl === 'string' ? pc.ttl.trim() : '';
+        parts.push(`🔥${remaining || ttl}`);
+    }
+    else if (pc?.caching_observed === true && pc.warm === false) {
+        const recache = positive(pc.recache_tokens_if_cold);
+        parts.push(`🧊${recache != null ? `↻${(0, format_1.fmtTokens)(recache)}` : ''}`);
+    }
+    return iconSeg(ctx, 'cache', colors_1.C.cache, 'cache', parts.join(colors_1.DOT));
 };
 const rateLimits = (ctx) => {
     const rl = ctx.data.rate_limits;
@@ -110,6 +146,7 @@ const rateLimits = (ctx) => {
     const labels = {
         five_hour: o.labels?.five_hour || 'Hour',
         seven_day: o.labels?.seven_day || 'Week',
+        spend_limit: o.labels?.spend_limit || 'Limit',
     };
     const normal = optTextColor(ctx, 'rate_limits', colors_1.C.rate);
     const bold = optBold(ctx, 'rate_limits');
@@ -123,18 +160,18 @@ const rateLimits = (ctx) => {
                     : pct >= 10 ? '🌒' : '🌑';
         return (0, colors_1.paint)(color, glyph, bold);
     };
-    const pushWindow = (label, win) => {
-        if (!win || win.used_percentage == null)
+    const pushWindow = (label, win, allowOver100 = false) => {
+        const pct = nonNegative(win?.used_percentage);
+        if (pct == null)
             return;
-        const pct = win.used_percentage;
         const warn = o.warnPct != null ? o.warnPct : 70;
         const danger = o.dangerPct != null ? o.dangerPct : 90;
         const winColor = pctColor(pct, warn, danger, normal);
-        const reset = showReset ? (0, format_1.fmtResetIn)(win.resets_at, ctx.nowMs) : null;
+        const reset = showReset ? (0, format_1.fmtResetIn)(win?.resets_at, ctx.nowMs) : null;
         const detail = [
             (0, colors_1.paint)(normal, label, bold),
             meter(pct, winColor),
-            (0, colors_1.paint)(winColor, fmtRatePct(pct), bold),
+            (0, colors_1.paint)(winColor, fmtRatePct(pct, allowOver100), bold),
         ];
         if (reset)
             detail.push((0, colors_1.paint)(colors_1.C.rateReset, '⏳', bold), (0, colors_1.paint)(colors_1.C.rateReset, reset, bold));
@@ -147,6 +184,9 @@ const rateLimits = (ctx) => {
     if (wants(['all', 'both', 'seven_day'])) {
         pushWindow(labels.seven_day, rl.seven_day);
     }
+    if (wants(['all', 'spend_limit'])) {
+        pushWindow(labels.spend_limit, rl.spend_limit, true);
+    }
     if (!parts.length)
         return null;
     const col = pctColor(maxUsed, o.warnPct != null ? o.warnPct : 70, o.dangerPct != null ? o.dangerPct : 90, normal);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cxmyu/ccglance",
-  "version": "1.2.1",
-  "description": "A fast, zero-dependency, multi-line status line for Claude Code — model, effort, context, cache, git and session, all at a glance.",
+  "version": "1.3.0",
+  "description": "A fast, zero-dependency Claude Code status line for model, effort, context, prompt cache, usage limits, git and session.",
   "bin": {
     "ccglance": "dist/cli.js"
   },
@@ -13,7 +13,8 @@
   "type": "commonjs",
   "files": [
     "dist",
-    "docs/assets/preview.png"
+    "docs/assets/preview-windows.png",
+    "docs/assets/preview-macos.png"
   ],
   "engines": {
     "node": ">=22"