cc-usage-bar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cc-usage-statusline contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# cc-usage-bar
+
+[中文说明](README.zh-CN.md)
+
+Show your Claude Code subscription usage in the statusline. Works with the official Anthropic subscription and 8 alternative providers (Kimi, GLM/Zhipu, MiniMax, DeepSeek, StepFun, SiliconFlow, OpenRouter, Novita).
+
+```
+5h 47% Wk 59%
+```
+
+Or, with `--format=bar-time`:
+
+```
+[█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00
+```
+
+## Install
+
+```bash
+npm install -g cc-usage-bar
+cc-usage-bar install
+```
+
+Restart Claude Code. That's it.
+
+To uninstall:
+
+```bash
+cc-usage-bar uninstall
+```
+
+The original `~/.claude/settings.json` is restored from a timestamped backup.
+
+## How it works
+
+A Claude Code statusline is just a shell command — its stdout is rendered to the bottom of the TUI. This package ships these binaries:
+
+- `cc-usage-fetch` — emits one statusline string. Called by Claude Code 30 s by default.
+- `cc-usage-bar` — installer. Wires `cc-usage-fetch` into `~/.claude/settings.json`'s `statusLine.command`. If you already have a statusline command, it's wrapped, not replaced.
+- `cc-usage-statusline` — compatibility alias for `cc-usage-bar`.
+
+`cc-usage-fetch` resolves usage data via three fallbacks, in order:
+
+1. **stdin `rate_limits`** — Claude Code now passes a `rate_limits` object to statusline stdin when you're a Claude.ai subscriber. Zero auth, zero network.
+2. **Local cache** — `/tmp/cc-oauth-usage.json`, 30 s TTL on success, 60 s on auth failure (so a stale token doesn't hammer the API).
+3. **Provider HTTP query** — picked from `ANTHROPIC_BASE_URL`. For Anthropic, the OAuth token is read from your macOS keychain (or `~/.claude/.credentials.json`). For the rest, `ANTHROPIC_AUTH_TOKEN` from the env.
+
+## Supported providers
+
+Provider detection runs against `ANTHROPIC_BASE_URL` (set by Claude Code from `settings.json` `env`, or by tools like cc-switch).
+
+| Type | Provider | Detected URL substring |
+|---|---|---|
+| Subscription (5h + 7d sliding window) | Anthropic | `anthropic.com` (or unset) |
+| Subscription | Kimi | `api.kimi.com` |
+| Subscription | GLM (Zhipu) | `z.ai`, `bigmodel.cn` |
+| Subscription | MiniMax | `minimaxi.com`, `minimax.io` |
+| Balance | DeepSeek | `api.deepseek.com` |
+| Balance | StepFun | `api.stepfun.com`, `api.stepfun.ai` |
+| Balance | SiliconFlow | `api.siliconflow.cn`, `api.siliconflow.com` |
+| Balance | OpenRouter | `openrouter.ai` |
+| Balance | Novita | `api.novita.ai` |
+
+Subscription mode renders `5h X% Wk Y%`. Balance mode renders `¥34.20` or `$5.88/$10.00`. Unknown providers render nothing (no error in the statusline).
+
+## Render presets
+
+```bash
+cc-usage-bar install --format <preset> --bar-width <n>
+```
+
+| Preset | Output |
+|---|---|
+| `compact` (default) | `5h 47% Wk 59%` |
+| `numeric` | `47% / 59%` |
+| `time` | `47% until 18:00 / 59% until 5/9 09:00` |
+| `bar` | `[█████░░░░░] 47% / [██████░░░░] 59%` |
+| `bar-time` | `[█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00` |
+
+**Time format is local-timezone, smart-truncated**: same day → `HH:MM`, within a week → `M/D HH:MM`, further → `YYYY-MM-DD`.
+
+**Color thresholds**: 5h window — green <60%, yellow <85%, red ≥85%. Weekly — bold red ≥80%. Set `NO_COLOR=1` to disable.
+
+### Custom template
+
+For full control, set `CC_USAGE_TEMPLATE` in `~/.claude/settings.json` `env`. It overrides `--format`.
+
+```json
+{
+  "env": {
+    "CC_USAGE_TEMPLATE": "{label}={percent}% ({expiry})"
+  }
+}
+```
+
+Placeholders: `{label}` (5h / Wk) · `{percent}` · `{bar}` · `{expiry}` · `{provider}` · `{amount}` (balance only).
+
+### Custom progress bar
+
+For AI-assisted personalization, pass one compact JSON object as `--bar-spec` or `CC_USAGE_BAR_SPEC`.
+The tool does not call AI or parse images itself; it only renders the JSON spec. Ask your AI assistant to convert an image, phrase, or theme into one of these shapes:
+
+```bash
+cc-usage-bar install --format=bar-time \
+  --bar-spec='{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}'
+```
+
+`tint` keeps the whole text visible and colors the completed prefix while dimming the rest:
+
+```json
+{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}
+```
+
+`cells` replaces the default block characters:
+
+```json
+{"mode":"cells","filled":"●","empty":"○","width":10}
+```
+
+`frames` selects one text frame based on usage percentage:
+
+```json
+{"mode":"frames","frames":["(・_・)","(・ω・)","(∠・ω< )","Ciallo～(∠・ω< )⌒★"]}
+```
+
+Suggested prompt for your AI assistant:
+
+```text
+Convert this image or phrase into a cc-usage-bar bar spec.
+Return only one JSON object using mode "tint", "cells", or "frames".
+Prefer "tint" for phrases, faces, logos, and decorative text.
+Keep it single-line and terminal-friendly.
+```
+
+### Manually editing the statusline
+
+Install just writes a command into `settings.json`. Edit it freely:
+
+```json
+"statusLine": {
+  "type": "command",
+  "command": "cc-usage-fetch --format=bar-time --bar-width=15",
+  "refreshInterval": 30
+}
+```
+
+## Diagnostics
+
+```bash
+cc-usage-bar status
+```
+
+Shows current provider, source (stdin / cache / api), 5h + 7d countdowns or balance breakdown. Bypasses the cache for accurate readings.
+
+```
+provider:      anthropic
+source:        api
+cache status:  miss
+base url:      <not set, defaults to anthropic>
+5-hour:        47% (resets in 3h 19m)
+7-day:         59% (resets in 9h 39m)
+```
+
+## Troubleshooting
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Statusline blank | Free tier (no `rate_limits` in stdin) and no Anthropic token, or unknown provider | Run `cc-usage-bar status`; check `ANTHROPIC_BASE_URL` |
+| `unauthorized (401)` in `status` | OAuth token expired or wrong `ANTHROPIC_AUTH_TOKEN` | Re-login: `claude` (Anthropic), or update token in cc-switch / settings.json |
+| Statusline shows old data | 30 s success cache | Wait, or `rm /tmp/cc-oauth-usage.json` |
+| Bar chars look like `??` | Terminal can't render Unicode block elements (U+2588, U+2591) | Use `--format=numeric` or set a Unicode-capable font |
+
+## Privacy & API stability
+
+This tool calls **two undocumented Anthropic endpoints**: `/api/oauth/usage` (subscription quota) and reads OAuth tokens from the local macOS keychain. The `cc-switch` project (Tauri/Rust) has used the same approach in production for months. **Both endpoints may change without notice** — open an issue if you see a regression.
+
+Tokens are read **only on your machine**. Nothing is uploaded anywhere. The tool makes one HTTPS request per refresh interval to the provider you've configured (or zero, when `rate_limits` is in stdin).
+
+For non-Anthropic providers, the same is true: the API key from `ANTHROPIC_AUTH_TOKEN` is sent only to the provider's published balance/quota endpoint.
+
+## Why no `jq` / `curl` dependency?
+
+Other statusline tools (e.g. `ccusage`) shell out to `jq` and `curl`. This one is pure Node.js (built-in `fetch` from Node 18+, `child_process` for the macOS keychain only). One `npm install -g` and you're done — no system tooling required.
+
+## Acknowledgements
+
+The provider adapter logic — endpoints, response parsing, the OAuth token discovery dance — is a Node port of [cc-switch](https://github.com/farion1231/cc-switch)'s Rust implementation (`src-tauri/src/services/{subscription,coding_plan,balance}.rs`). Thanks to that project for reverse-engineering and maintaining the Chinese-provider integrations.
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,198 @@
+# 中文说明
+
+[English](README.md)
+
+`cc-usage-bar` 可以把 Claude Code 的订阅用量显示在底部 statusline。它支持官方 Anthropic 订阅，也支持 Kimi、GLM/Zhipu、MiniMax、DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita 等替代 provider。
+
+默认效果：
+
+```text
+5h 47% Wk 59%
+```
+
+进度条 + 重置时间：
+
+```text
+[█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00
+```
+
+## 安装
+
+```bash
+npm install -g cc-usage-bar
+cc-usage-bar install
+```
+
+然后重启 Claude Code。
+
+卸载：
+
+```bash
+cc-usage-bar uninstall
+```
+
+安装时会备份原来的 `~/.claude/settings.json`。如果你已经有自己的 statusline 命令，本工具会包装它，不会直接覆盖。
+
+## 工作原理
+
+Claude Code 的 statusline 本质上是一条 shell 命令，命令的 stdout 会显示在 TUI 底部。本项目提供这些命令：
+
+- `cc-usage-fetch`：输出一行 statusline 文本，默认由 Claude Code 每 30 秒调用一次。
+- `cc-usage-bar`：安装器，把 `cc-usage-fetch` 写入 `~/.claude/settings.json` 的 `statusLine.command`。
+- `cc-usage-statusline`：`cc-usage-bar` 的兼容别名。
+
+`cc-usage-fetch` 会按下面顺序获取数据：
+
+1. **stdin `rate_limits`**：Claude Code 会把订阅用户的 `rate_limits` 传给 statusline，无需鉴权、无需网络。
+2. **本地缓存**：`/tmp/cc-oauth-usage.json`，成功缓存 30 秒，鉴权失败缓存 60 秒。
+3. **Provider HTTP 查询**：根据 `ANTHROPIC_BASE_URL` 自动选择 provider。Anthropic 会读取 macOS keychain 或 `~/.claude/.credentials.json`；其他 provider 使用环境变量 `ANTHROPIC_AUTH_TOKEN`。
+
+## 支持的 Provider
+
+Provider 通过 `ANTHROPIC_BASE_URL` 判断。
+
+| 类型 | Provider | URL 关键词 |
+|---|---|---|
+| 订阅用量 | Anthropic | `anthropic.com` 或不设置 |
+| 订阅用量 | Kimi | `api.kimi.com` |
+| 订阅用量 | GLM / 智谱 | `z.ai`, `bigmodel.cn` |
+| 订阅用量 | MiniMax | `minimaxi.com`, `minimax.io` |
+| 余额 | DeepSeek | `api.deepseek.com` |
+| 余额 | StepFun | `api.stepfun.com`, `api.stepfun.ai` |
+| 余额 | SiliconFlow | `api.siliconflow.cn`, `api.siliconflow.com` |
+| 余额 | OpenRouter | `openrouter.ai` |
+| 余额 | Novita | `api.novita.ai` |
+
+订阅模式显示 `5h X% Wk Y%`。余额模式显示 `¥34.20` 或 `$5.88/$10.00`。未知 provider 会输出空字符串，不会污染 statusline。
+
+## 显示格式
+
+```bash
+cc-usage-bar install --format <preset> --bar-width <n>
+```
+
+| 预设 | 输出示例 |
+|---|---|
+| `compact` 默认 | `5h 47% Wk 59%` |
+| `numeric` | `47% / 59%` |
+| `time` | `47% until 18:00 / 59% until 5/9 09:00` |
+| `bar` | `[█████░░░░░] 47% / [██████░░░░] 59%` |
+| `bar-time` | `[█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00` |
+
+时间使用本地时区，并做智能缩短：当天显示 `HH:MM`，一周内显示 `M/D HH:MM`，更久显示 `YYYY-MM-DD`。
+
+颜色规则：5 小时窗口低于 60% 为绿色，低于 85% 为黄色，85% 及以上为红色；周用量 80% 及以上为加粗红色。设置 `NO_COLOR=1` 可以关闭颜色。
+
+### 自定义模板
+
+如果想完全控制文本，可以在 `~/.claude/settings.json` 的 `env` 里设置 `CC_USAGE_TEMPLATE`：
+
+```json
+{
+  "env": {
+    "CC_USAGE_TEMPLATE": "{label}={percent}% ({expiry})"
+  }
+}
+```
+
+可用占位符：`{label}`、`{percent}`、`{bar}`、`{expiry}`、`{provider}`、`{amount}`。
+
+### 自定义进度条
+
+本项目提供一个适合 AI 使用的轻量入口：`--bar-spec` 或 `CC_USAGE_BAR_SPEC`。
+
+工具本身不会调用 AI，也不会解析图片；它只负责渲染 JSON。你可以让自己的 AI 助手把图片、短语、主题转换成下面几种 spec。
+
+#### tint：整段文字始终可见
+
+推荐给颜文字、短句、logo 风格文本。已完成部分会染色，未完成部分会变暗，但整段文字一直可见：
+
+```bash
+cc-usage-bar install --format=bar-time \
+  --bar-spec='{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}'
+```
+
+```json
+{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}
+```
+
+#### cells：替换默认块字符
+
+```json
+{"mode":"cells","filled":"●","empty":"○","width":10}
+```
+
+#### frames：按百分比选择阶段文本
+
+```json
+{"mode":"frames","frames":["(・_・)","(・ω・)","(∠・ω< )","Ciallo～(∠・ω< )⌒★"]}
+```
+
+可以直接把下面这段发给你的 AI 助手：
+
+```text
+请把这张图片、这句话或这个主题转换成 cc-usage-bar 的 bar spec。
+只返回一个 JSON 对象，mode 使用 "tint"、"cells" 或 "frames"。
+短语、颜文字、logo、装饰文本优先使用 "tint"，因为它会让整段文字始终可见，只按进度染色。
+输出必须是单行、终端友好、适合放进 --bar-spec 的 JSON。
+```
+
+### 手动编辑 statusline
+
+安装命令只是写入 `settings.json`，你可以手动调整：
+
+```json
+"statusLine": {
+  "type": "command",
+  "command": "cc-usage-fetch --format=bar-time --bar-width=15",
+  "refreshInterval": 30
+}
+```
+
+## 诊断
+
+```bash
+cc-usage-bar status
+```
+
+会显示当前 provider、数据来源、缓存状态、5 小时 / 7 天重置倒计时，或余额详情。该命令会跳过缓存，适合排查问题。
+
+示例：
+
+```text
+provider:      anthropic
+source:        api
+cache status:  miss
+base url:      <not set, defaults to anthropic>
+5-hour:        47% (resets in 3h 19m)
+7-day:         59% (resets in 9h 39m)
+```
+
+## 常见问题
+
+| 现象 | 原因 | 处理 |
+|---|---|---|
+| statusline 为空 | 免费用户没有 stdin `rate_limits`，也没有可用 token；或 provider 未识别 | 运行 `cc-usage-bar status`，检查 `ANTHROPIC_BASE_URL` |
+| `unauthorized (401)` | OAuth token 过期，或 `ANTHROPIC_AUTH_TOKEN` 错误 | Anthropic 重新运行 `claude` 登录；其他 provider 更新 token |
+| statusline 显示旧数据 | 成功结果有 30 秒缓存 | 等待，或删除 `/tmp/cc-oauth-usage.json` |
+| 进度条显示成 `??` | 终端字体不支持 Unicode 块字符 | 使用 `--format=numeric`，或换支持 Unicode 的字体 |
+
+## 隐私与 API 稳定性
+
+Anthropic 订阅用量依赖未公开接口 `/api/oauth/usage`，并会从本机 macOS keychain 或 `~/.claude/.credentials.json` 读取 Claude Code OAuth token。这些接口可能变化。
+
+Token 只在你的机器上读取，不会上传到本项目的任何服务。工具只会请求你配置的 provider。使用 stdin `rate_limits` 时不需要网络。
+
+非 Anthropic provider 也是同样逻辑：`ANTHROPIC_AUTH_TOKEN` 只会发送给对应 provider 的余额或用量接口。
+
+## 为什么不依赖 jq / curl
+
+这个工具是纯 Node.js 实现，Node 18+ 自带 `fetch`，只在 macOS 读取 keychain 时使用 `child_process`。安装后直接可用，不需要额外安装 `jq` 或 `curl`。
+
+## 致谢
+
+Provider 适配逻辑，包括接口地址、响应解析和 OAuth token 发现流程，参考并移植自 [cc-switch](https://github.com/farion1231/cc-switch) 的 Rust 实现（`src-tauri/src/services/{subscription,coding_plan,balance}.rs`）。感谢该项目对国内 provider 集成的逆向和维护。
+
+## License
+
+MIT

package/bin/cc-usage-fetch.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+require('../dist/src/fetch.js')
+  .main()
+  .catch(() => {
+    // silent — never pollute the statusline
+    process.exit(0);
+  });

package/bin/cc-usage-statusline.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/src/cli.js');

package/dist/src/cli.js

@@ -0,0 +1,241 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const settings_1 = require("./settings");
+const fetch_1 = require("./fetch");
+const format_1 = require("./format");
+function readPkgVersion() {
+    try {
+        const pkgPath = path.join(__dirname, '..', '..', 'package.json');
+        const raw = fs.readFileSync(pkgPath, 'utf8');
+        return JSON.parse(raw).version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function formatCountdown(iso) {
+    if (!iso)
+        return 'unknown';
+    const target = new Date(iso).getTime();
+    if (Number.isNaN(target))
+        return 'unknown';
+    const diffMs = target - Date.now();
+    if (diffMs <= 0)
+        return 'now';
+    const totalMin = Math.floor(diffMs / 60_000);
+    const days = Math.floor(totalMin / (60 * 24));
+    const hours = Math.floor((totalMin % (60 * 24)) / 60);
+    const mins = totalMin % 60;
+    if (days > 0)
+        return `${days}d ${hours}h ${mins}m`;
+    if (hours > 0)
+        return `${hours}h ${mins}m`;
+    return `${mins}m`;
+}
+function loadSettingsOrExit() {
+    try {
+        return (0, settings_1.readSettings)();
+    }
+    catch (e) {
+        if (e instanceof settings_1.SettingsError) {
+            console.error(`error: ${e.message}`);
+            if (e.hint)
+                console.error(`hint:  ${e.hint}`);
+            process.exit(1);
+        }
+        throw e;
+    }
+}
+async function runInstall(force, installOpts) {
+    if (!(0, settings_1.claudeDirExists)()) {
+        console.error('No ~/.claude/ directory found. Install Claude Code and run `claude` to log in first.');
+        process.exit(1);
+    }
+    const settings = loadSettingsOrExit();
+    if ((0, settings_1.isInstalled)(settings) && !force) {
+        console.log('Already installed. Run `cc-usage-statusline uninstall` first, or pass --force to reinstall.');
+        return;
+    }
+    const backup = (0, settings_1.backupSettings)();
+    const next = (0, settings_1.applyInstall)(settings, installOpts);
+    (0, settings_1.writeSettings)(next);
+    console.log(`✓ Updated ${settings_1.SETTINGS_PATH}`);
+    if (backup)
+        console.log(`✓ Backup:  ${backup}`);
+    process.stdout.write('Verifying… ');
+    const result = await (0, fetch_1.run)({ forceFresh: true, skipStdin: true });
+    if (result.data) {
+        const summary = result.data.kind === 'subscription'
+            ? `5h ${Math.round(result.data.five_hour?.utilization ?? 0)}% / 7d ${Math.round(result.data.seven_day?.utilization ?? 0)}%`
+            : `${result.data.remaining.toFixed(2)} ${result.data.unit}`;
+        console.log(`OK [${result.adapterId}] ${summary}`);
+        console.log('Restart Claude Code to see the statusline.');
+        return;
+    }
+    console.log('FAIL');
+    if (!result.adapterId) {
+        console.error('  → No matching provider. Check ANTHROPIC_BASE_URL.');
+    }
+    else if (result.authFailed) {
+        console.error('  → Auth failed. Re-login with `claude` (Anthropic) or check ANTHROPIC_AUTH_TOKEN.');
+    }
+    else if (result.error) {
+        console.error(`  → ${result.error}`);
+    }
+    console.error('(Settings were still updated. Run `cc-usage-statusline status` to retry diagnostics.)');
+}
+async function runUninstall() {
+    if (!(0, settings_1.claudeDirExists)()) {
+        console.log('Nothing to do — no ~/.claude/ directory.');
+        return;
+    }
+    const settings = loadSettingsOrExit();
+    if ((0, settings_1.isInstalled)(settings)) {
+        const latest = (0, settings_1.findLatestBackup)();
+        if (latest) {
+            (0, settings_1.restoreFromBackup)(latest);
+            const removed = (0, settings_1.deleteBackups)();
+            console.log(`✓ Restored from backup: ${latest}`);
+            console.log(`✓ Cleaned up ${removed} backup file(s).`);
+            console.log('Restart Claude Code for changes to take effect.');
+            return;
+        }
+    }
+    const next = (0, settings_1.applyUninstallSurgical)(settings);
+    (0, settings_1.writeSettings)(next);
+    const removed = (0, settings_1.deleteBackups)();
+    console.log('✓ Removed cc-usage-fetch from statusLine (surgical mode).');
+    if (removed > 0)
+        console.log(`✓ Cleaned up ${removed} backup file(s).`);
+    console.log('Restart Claude Code for changes to take effect.');
+}
+async function runStatus() {
+    const result = await (0, fetch_1.run)({ forceFresh: true, skipStdin: true });
+    console.log(`provider:      ${result.adapterId ?? '<none>'}`);
+    console.log(`source:        ${result.source}`);
+    console.log(`cache status:  ${result.cacheStatus}`);
+    console.log(`base url:      ${process.env.ANTHROPIC_BASE_URL ?? '<not set, defaults to anthropic>'}`);
+    if (result.error)
+        console.log(`error:         ${result.error}`);
+    if (result.authFailed) {
+        console.log('→ Auth failed. Re-login (Anthropic) or check ANTHROPIC_AUTH_TOKEN.');
+        return;
+    }
+    if (!result.data) {
+        if (!result.adapterId) {
+            console.log('→ Configure ANTHROPIC_BASE_URL to a supported provider, or leave unset for Anthropic.');
+        }
+        return;
+    }
+    if (result.data.kind === 'subscription') {
+        const fh = result.data.five_hour;
+        const wk = result.data.seven_day;
+        if (result.data.planName)
+            console.log(`plan:          ${result.data.planName}`);
+        if (fh)
+            console.log(`5-hour:        ${Math.round(fh.utilization)}% (resets in ${formatCountdown(fh.resets_at)})`);
+        if (wk)
+            console.log(`7-day:         ${Math.round(wk.utilization)}% (resets in ${formatCountdown(wk.resets_at)})`);
+    }
+    else {
+        const d = result.data;
+        if (d.planName)
+            console.log(`plan:          ${d.planName}`);
+        console.log(`remaining:     ${d.remaining.toFixed(2)} ${d.unit}`);
+        if (typeof d.total === 'number')
+            console.log(`total:         ${d.total.toFixed(2)} ${d.unit}`);
+        if (typeof d.used === 'number')
+            console.log(`used:          ${d.used.toFixed(2)} ${d.unit}`);
+    }
+}
+const program = new commander_1.Command();
+program
+    .name('cc-usage-statusline')
+    .description('Show your Claude Code subscription usage in the statusline.')
+    .version(readPkgVersion());
+program
+    .command('install')
+    .description('Install statusline integration into ~/.claude/settings.json')
+    .option('-f, --force', 'overwrite if already installed')
+    .option('--format <preset>', `render preset (${format_1.FORMAT_PRESETS.join(' | ')})`, 'compact')
+    .option('--bar-width <n>', 'bar width when format includes a bar (1-50)', '10')
+    .option('--bar-spec <json>', 'custom bar JSON spec (cells, tint, or frames)')
+    .action(async (opts) => {
+    const installOpts = {};
+    if (opts.format && opts.format !== 'compact') {
+        if (!(0, format_1.isValidPreset)(opts.format)) {
+            console.error(`error: --format must be one of ${format_1.FORMAT_PRESETS.join(', ')}`);
+            process.exit(1);
+        }
+        installOpts.format = opts.format;
+    }
+    if (opts.barWidth) {
+        const n = parseInt(opts.barWidth, 10);
+        if (!Number.isFinite(n) || n < 1 || n > 50) {
+            console.error('error: --bar-width must be 1..50');
+            process.exit(1);
+        }
+        if (n !== 10)
+            installOpts.barWidth = n;
+    }
+    if (opts.barSpec) {
+        if (!(0, format_1.parseBarSpec)(opts.barSpec)) {
+            console.error('error: --bar-spec must be valid cells, tint, or frames JSON');
+            process.exit(1);
+        }
+        installOpts.barSpec = opts.barSpec;
+    }
+    await runInstall(!!opts.force, installOpts);
+});
+program
+    .command('uninstall')
+    .description('Remove statusline integration; restore from backup if possible')
+    .action(async () => {
+    await runUninstall();
+});
+program
+    .command('status')
+    .description('Diagnose: token source, current usage, reset countdowns, cache state')
+    .action(async () => {
+    await runStatus();
+});
+program.parseAsync(process.argv).catch((e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+});