pi-cliproxy-usage 0.1.0 → 0.2.0

package/README.md

@@ -1,64 +1,72 @@
-# pi-cliproxy-usage
-
-Compact CLIProxyAPI account usage meters for Pi Coding Agent.
-
-Code layout:
-
-- `index.ts` — Pi lifecycle and command wiring
-- `src/settings.ts` / `src/settings-ui.ts` — persisted and interactive settings
-- `src/usage.ts` / `src/parsers.ts` — account discovery, provider requests, response mapping
-- `src/ui.ts` — widget rendering and text formatting
-
-Shows one colored line below editor per enabled account:
-
-```text
-◆ Claude user  S ███████░░░ 70%  │  W ████░░░░░░ 40%
-◆ Codex user   S █████████░ 90%
-◆ Grok user    W █████░░░░░ 50%
-```
-
-Percentages and filled bars show usage **consumed**. Colors shift green → yellow at 70% → red at 90%. Codex intentionally shows Session only; weekly meter is omitted.
-
-## Install
-
-```bash
-pi install ./path/to/pi-cliproxy-usage
-```
-
-Or test directly:
-
-```bash
-pi -e ./index.ts
-```
-
-## Settings
-
-User file: `<getAgentDir()>/pi-cliproxy-usage.json` (normally `~/.pi/agent/pi-cliproxy-usage.json`). Missing file uses defaults. Changes from interactive UI apply immediately. Settings reload on session start and `/reload`.
-
-Older `~/.pi/agent/extensions/pi-cliproxy-usage/config.json` files migrate automatically when canonical file does not exist.
-
-```json
-{
-  "accountsDir": "~/.cli-proxy-api",
-  "refreshMinutes": 5,
-  "providers": {
-    "claude": true,
-    "codex": true,
-    "grok": true
-  }
-}
-```
-
-Extension reads top-level CLIProxyAPI auth JSON files with `type` equal to `claude`, `codex`, or `xai`. Disabled auth files are skipped. Credentials stay local and are sent only to official provider usage endpoints documented by OpenUsage.
-
-Accepted values: `accountsDir` is a non-empty string, `refreshMinutes` is an integer of at least `1`, and provider values are booleans. Invalid values are ignored with a warning. Unknown fields are preserved when saving.
-
-## Commands
-
-- `/cliproxy-usage` — refresh and show detailed percentages
-- `/cliproxy-usage settings` — interactively edit refresh interval and provider toggles
-- `/cliproxy-usage status` — show effective values, source, and settings path
-- `/cliproxy-usage help` — show commands and manual settings path
-- `/cliproxy-usage config` — compatibility alias for `settings`
-
-Token refresh is deliberately left to CLIProxyAPI. If provider returns `401`/`403`, let CLIProxyAPI refresh account or log in again.
+# pi-cliproxy-usage
+
+Compact CLIProxyAPI account usage meters for Pi Coding Agent.
+
+Shows one colored line below editor per enabled account:
+
+```text
+● Claude │ user │ S ███████░░░ 70%  │  W ████░░░░░░ 40%
+● Codex │ user │ S █████████░ 90%
+● Grok │ user │ W █████░░░░░ 50%
+```
+
+Percentages and filled bars show usage **consumed**. Colors shift green → yellow at 70% → red at 90%. Codex intentionally shows Session only; weekly meter is omitted.
+
+## Requirements
+
+- [Pi Coding Agent](https://github.com/earendil-works/pi)
+- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) with at least one Claude, Codex, or Grok account configured
+
+## Install
+
+```bash
+pi install npm:pi-cliproxy-usage
+```
+
+After installing or updating, run `/reload` in Pi.
+
+Or test directly:
+
+```bash
+pi -e ./index.ts
+```
+
+## Settings
+
+User file: `<getAgentDir()>/pi-cliproxy-usage.json` (normally `~/.pi/agent/pi-cliproxy-usage.json`). Missing file uses defaults. Changes from interactive UI apply immediately. Settings reload on session start and `/reload`.
+
+Older `~/.pi/agent/extensions/pi-cliproxy-usage/config.json` files migrate automatically when canonical file does not exist.
+
+```json
+{
+  "accountsDir": "~/.cli-proxy-api",
+  "refreshMinutes": 5,
+  "providers": {
+    "claude": true,
+    "codex": true,
+    "grok": true
+  }
+}
+```
+
+Extension reads top-level CLIProxyAPI auth JSON files with `type` equal to `claude`, `codex`, or `xai`. Disabled auth files are skipped. Credentials stay local and are sent only to official provider usage endpoints documented by OpenUsage.
+
+Accepted values: `accountsDir` is a non-empty string, `refreshMinutes` is an integer of at least `1`, and provider values are booleans. Invalid values are ignored with a warning. Unknown fields are preserved when saving.
+
+## Commands
+
+- `/cliproxy-usage` — refresh and show detailed percentages
+- `/cliproxy-usage settings` — interactively edit refresh interval and provider toggles
+- `/cliproxy-usage status` — show effective values, source, and settings path
+- `/cliproxy-usage help` — show commands and manual settings path
+- `/cliproxy-usage config` — compatibility alias for `settings`
+
+Token refresh is deliberately left to CLIProxyAPI. If provider returns `401`/`403`, let CLIProxyAPI refresh account or log in again.
+
+## Screenshot
+
+![CLIProxyAPI usage widget](docs/preview.png)
+
+## Support
+
+Report bugs and request features in [GitHub Issues](https://github.com/Villoh/pi-cliproxy-usage/issues).

package/package.json

@@ -1,28 +1,43 @@
-{
-  "name": "pi-cliproxy-usage",
-  "version": "0.1.0",
-  "description": "Compact CLIProxyAPI account usage meters for Pi Coding Agent",
-  "type": "module",
-  "keywords": ["pi-package", "cliproxyapi", "usage"],
-  "license": "MIT",
-  "files": ["index.ts", "src", "README.md"],
-  "pi": {
-    "extensions": ["./index.ts"]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*"
-  },
-  "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.80.10",
-    "@earendil-works/pi-ai": "0.80.10",
-    "@earendil-works/pi-coding-agent": "0.80.10",
-    "@earendil-works/pi-tui": "0.80.10",
-    "@types/node": "^24.10.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
-  },
-  "scripts": {
-    "check": "tsc --noEmit",
-    "test": "node --import tsx --test test/**/*.test.ts"
-  }
-}
+{
+  "name": "pi-cliproxy-usage",
+  "version": "0.2.0",
+  "description": "Compact CLIProxyAPI account usage meters for Pi Coding Agent",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "cliproxyapi",
+    "usage"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Villoh/pi-cliproxy-usage.git"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.80.10",
+    "@earendil-works/pi-ai": "0.80.10",
+    "@earendil-works/pi-coding-agent": "0.80.10",
+    "@earendil-works/pi-tui": "0.80.10",
+    "@types/node": "^24.10.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "check": "tsc --noEmit",
+    "test": "node --import tsx --test test/**/*.test.ts"
+  }
+}

package/src/parsers.ts

@@ -1,82 +1,82 @@
-import type { AccountUsage, UsageWindow } from "./types.js";
-
-export function toNumber(value: unknown): number | undefined {
-	if (typeof value === "number" && Number.isFinite(value)) return value;
-	if (typeof value === "string" && value.trim()) {
-		const parsed = Number(value);
-		if (Number.isFinite(parsed)) return parsed;
-	}
-	return undefined;
-}
-
-function toDate(value: unknown): Date | undefined {
-	if (typeof value === "string") {
-		const parsed = new Date(value);
-		return Number.isNaN(parsed.getTime()) ? undefined : parsed;
-	}
-	const raw = toNumber(value);
-	if (raw === undefined) return undefined;
-	return new Date(raw < 1e10 ? raw * 1000 : raw);
-}
-
-export function parseClaude(
-	body: unknown,
-): Pick<AccountUsage, "session" | "weekly"> {
-	const root = body as Record<string, unknown>;
-	const window = (value: unknown): UsageWindow | undefined => {
-		const item = value as Record<string, unknown> | undefined;
-		const used = toNumber(item?.utilization);
-		return used === undefined
-			? undefined
-			: { used, resetsAt: toDate(item?.resets_at) };
-	};
-	return { session: window(root?.five_hour), weekly: window(root?.seven_day) };
-}
-
-function codexWindow(
-	value: unknown,
-): (UsageWindow & { seconds?: number }) | undefined {
-	const item = value as Record<string, unknown> | undefined;
-	const used = toNumber(item?.used_percent);
-	if (used === undefined) return undefined;
-	const resetAfter = toNumber(item?.reset_after_seconds);
-	return {
-		used,
-		seconds: toNumber(item?.limit_window_seconds),
-		resetsAt:
-			toDate(item?.reset_at) ??
-			(resetAfter === undefined
-				? undefined
-				: new Date(Date.now() + resetAfter * 1000)),
-	};
-}
-
-export function parseCodex(body: unknown): Pick<AccountUsage, "session"> {
-	const rate = (body as Record<string, unknown>)?.rate_limit as
-		| Record<string, unknown>
-		| undefined;
-	const windows = [
-		codexWindow(rate?.primary_window),
-		codexWindow(rate?.secondary_window),
-	].filter(Boolean) as Array<UsageWindow & { seconds?: number }>;
-	return {
-		session:
-			windows.find((item) => item.seconds === 18_000) ??
-			windows.find((item) => item.seconds !== 604_800) ??
-			windows[0],
-	};
-}
-
-export function parseGrok(body: unknown): Pick<AccountUsage, "weekly"> {
-	const config = (body as Record<string, unknown>)?.config as
-		| Record<string, unknown>
-		| undefined;
-	const period = config?.currentPeriod as Record<string, unknown> | undefined;
-	if (period?.type !== "USAGE_PERIOD_TYPE_WEEKLY") return {};
-	return {
-		weekly: {
-			used: toNumber(config?.creditUsagePercent) ?? 0,
-			resetsAt: toDate(period.end),
-		},
-	};
-}
+import type { AccountUsage, UsageWindow } from "./types.js";
+
+export function toNumber(value: unknown): number | undefined {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim()) {
+		const parsed = Number(value);
+		if (Number.isFinite(parsed)) return parsed;
+	}
+	return undefined;
+}
+
+function toDate(value: unknown): Date | undefined {
+	if (typeof value === "string") {
+		const parsed = new Date(value);
+		return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+	}
+	const raw = toNumber(value);
+	if (raw === undefined) return undefined;
+	return new Date(raw < 1e10 ? raw * 1000 : raw);
+}
+
+export function parseClaude(
+	body: unknown,
+): Pick<AccountUsage, "session" | "weekly"> {
+	const root = body as Record<string, unknown>;
+	const window = (value: unknown): UsageWindow | undefined => {
+		const item = value as Record<string, unknown> | undefined;
+		const used = toNumber(item?.utilization);
+		return used === undefined
+			? undefined
+			: { used, resetsAt: toDate(item?.resets_at) };
+	};
+	return { session: window(root?.five_hour), weekly: window(root?.seven_day) };
+}
+
+function codexWindow(
+	value: unknown,
+): (UsageWindow & { seconds?: number }) | undefined {
+	const item = value as Record<string, unknown> | undefined;
+	const used = toNumber(item?.used_percent);
+	if (used === undefined) return undefined;
+	const resetAfter = toNumber(item?.reset_after_seconds);
+	return {
+		used,
+		seconds: toNumber(item?.limit_window_seconds),
+		resetsAt:
+			toDate(item?.reset_at) ??
+			(resetAfter === undefined
+				? undefined
+				: new Date(Date.now() + resetAfter * 1000)),
+	};
+}
+
+export function parseCodex(body: unknown): Pick<AccountUsage, "session"> {
+	const rate = (body as Record<string, unknown>)?.rate_limit as
+		| Record<string, unknown>
+		| undefined;
+	const windows = [
+		codexWindow(rate?.primary_window),
+		codexWindow(rate?.secondary_window),
+	].filter(Boolean) as Array<UsageWindow & { seconds?: number }>;
+	return {
+		session:
+			windows.find((item) => item.seconds === 18_000) ??
+			windows.find((item) => item.seconds !== 604_800) ??
+			windows[0],
+	};
+}
+
+export function parseGrok(body: unknown): Pick<AccountUsage, "weekly"> {
+	const config = (body as Record<string, unknown>)?.config as
+		| Record<string, unknown>
+		| undefined;
+	const period = config?.currentPeriod as Record<string, unknown> | undefined;
+	if (period?.type !== "USAGE_PERIOD_TYPE_WEEKLY") return {};
+	return {
+		weekly: {
+			used: toNumber(config?.creditUsagePercent) ?? 0,
+			resetsAt: toDate(period.end),
+		},
+	};
+}

package/src/ui.ts

@@ -1,131 +1,134 @@
-import type {
-	AccountUsage,
-	ProviderName,
-	Theme,
-	UiContext,
-	UsageWindow,
-} from "./types.js";
-
-const PROVIDER_LABELS: Record<ProviderName, string> = {
-	claude: "Claude",
-	codex: "Codex",
-	grok: "Grok",
-};
-
-function accountLabel(label: string): string {
-	const local = label.includes("@") ? label.split("@")[0] : label;
-	return local.slice(0, 18);
-}
-
-export function usageBar(used: number, width = 10): string {
-	const percent = Math.max(0, Math.min(100, used));
-	const filled = Math.round((percent / 100) * width);
-	return "█".repeat(filled) + "░".repeat(width - filled);
-}
-
-export function formatCompact(items: AccountUsage[]): string {
-	return items
-		.map((item) => {
-			if (item.error) {
-				return `${PROVIDER_LABELS[item.provider]} ${accountLabel(item.label)}: ! ${item.error}`;
-			}
-			const windows = [
-				item.session &&
-					`S ${usageBar(item.session.used)} ${Math.round(item.session.used)}%`,
-				item.weekly &&
-					`W ${usageBar(item.weekly.used)} ${Math.round(item.weekly.used)}%`,
-			].filter(Boolean);
-			return `${PROVIDER_LABELS[item.provider]} ${accountLabel(item.label)}  ${windows.join("  ") || "–"}`;
-		})
-		.join("\n");
-}
-
-export function formatDetails(items: AccountUsage[]): string {
-	if (!items.length) return "No enabled CLIProxyAPI accounts found.";
-	return items
-		.map((item) => {
-			if (item.error) return `${item.provider}/${item.label}: ${item.error}`;
-			const windows = [
-				item.session && `Session ${item.session.used.toFixed(0)}% used`,
-				item.weekly && `Weekly ${item.weekly.used.toFixed(0)}% used`,
-			].filter(Boolean);
-			return `${item.provider}/${item.label}: ${windows.join(" · ") || "No usage window"}`;
-		})
-		.join("\n");
-}
-
-function truncateAnsi(text: string, width: number): string {
-	let visible = 0;
-	let result = "";
-	for (let index = 0; index < text.length && visible < width; ) {
-		if (text[index] === "\u001b") {
-			const match = text.slice(index).match(/^\u001b\[[0-?]*[ -/]*[@-~]/);
-			if (match) {
-				result += match[0];
-				index += match[0].length;
-				continue;
-			}
-		}
-		const point = text.codePointAt(index);
-		if (point === undefined) break;
-		result += String.fromCodePoint(point);
-		index += point > 0xffff ? 2 : 1;
-		visible++;
-	}
-	return `${result}\u001b[0m`;
-}
-
-export function clearUsage(ctx: UiContext): void {
-	ctx.ui.setStatus("cliproxy-usage", undefined);
-	ctx.ui.setWidget("cliproxy-usage", undefined);
-}
-
-export function renderUsage(ctx: UiContext, items: AccountUsage[]): void {
-	ctx.ui.setStatus("cliproxy-usage", undefined);
-	if (!items.length) {
-		ctx.ui.setWidget("cliproxy-usage", undefined);
-		return;
-	}
-	ctx.ui.setWidget(
-		"cliproxy-usage",
-		(_tui: unknown, theme: Theme) => ({
-			invalidate() {},
-			render(width: number): string[] {
-				return items.map((item) => {
-					const providerColor =
-						item.provider === "claude"
-							? "warning"
-							: item.provider === "codex"
-								? "success"
-								: "accent";
-					const prefix =
-						theme.fg(providerColor, `◆ ${PROVIDER_LABELS[item.provider]}`) +
-						theme.fg("muted", ` ${accountLabel(item.label)}`);
-					if (item.error) {
-						return truncateAnsi(
-							`${prefix}  ${theme.fg("error", `! ${item.error}`)}`,
-							width,
-						);
-					}
-					const meter = (name: string, usage: UsageWindow) => {
-						const used = Math.max(0, Math.min(100, usage.used));
-						const color =
-							used >= 90 ? "error" : used >= 70 ? "warning" : "success";
-						const filled = usageBar(used).replace(/░+$/, "");
-						const empty = "░".repeat(10 - filled.length);
-						return `${theme.fg("muted", name)} ${theme.fg(color, filled)}${theme.fg("dim", empty)} ${theme.fg(color, `${Math.round(used)}%`)}`;
-					};
-					const windows = [
-						item.session && meter("S", item.session),
-						item.weekly && meter("W", item.weekly),
-					].filter(Boolean);
-					return truncateAnsi(
-						`${prefix}  ${windows.join(theme.fg("dim", "  │  "))}`,
-						width,
-					);
-				});
-			},
-		}),
-		{ placement: "belowEditor" },
-	);
-}
+import type {
+	AccountUsage,
+	ProviderName,
+	Theme,
+	UiContext,
+	UsageWindow,
+} from "./types.js";
+
+const PROVIDER_LABELS: Record<ProviderName, string> = {
+	claude: "Claude",
+	codex: "Codex",
+	grok: "Grok",
+};
+
+function accountLabel(label: string): string {
+	const local = label.includes("@") ? label.split("@")[0] : label;
+	return local.slice(0, 18);
+}
+
+export function usageBar(used: number, width = 10): string {
+	const percent = Math.max(0, Math.min(100, used));
+	const filled = Math.round((percent / 100) * width);
+	return "█".repeat(filled) + "░".repeat(width - filled);
+}
+
+export function formatCompact(items: AccountUsage[]): string {
+	return items
+		.map((item) => {
+			if (item.error) {
+				return `${PROVIDER_LABELS[item.provider]} ${accountLabel(item.label)}: ! ${item.error}`;
+			}
+			const windows = [
+				item.session &&
+					`S ${usageBar(item.session.used)} ${Math.round(item.session.used)}%`,
+				item.weekly &&
+					`W ${usageBar(item.weekly.used)} ${Math.round(item.weekly.used)}%`,
+			].filter(Boolean);
+			return `${PROVIDER_LABELS[item.provider]} ${accountLabel(item.label)}  ${windows.join("  ") || "–"}`;
+		})
+		.join("\n");
+}
+
+export function formatDetails(items: AccountUsage[]): string {
+	if (!items.length) return "No enabled CLIProxyAPI accounts found.";
+	return items
+		.map((item) => {
+			if (item.error) return `${item.provider}/${item.label}: ${item.error}`;
+			const windows = [
+				item.session && `Session ${item.session.used.toFixed(0)}% used`,
+				item.weekly && `Weekly ${item.weekly.used.toFixed(0)}% used`,
+			].filter(Boolean);
+			return `${item.provider}/${item.label}: ${windows.join(" · ") || "No usage window"}`;
+		})
+		.join("\n");
+}
+
+function truncateAnsi(text: string, width: number): string {
+	let visible = 0;
+	let result = "";
+	for (let index = 0; index < text.length && visible < width; ) {
+		if (text[index] === "\u001b") {
+			const match = text.slice(index).match(/^\u001b\[[0-?]*[ -/]*[@-~]/);
+			if (match) {
+				result += match[0];
+				index += match[0].length;
+				continue;
+			}
+		}
+		const point = text.codePointAt(index);
+		if (point === undefined) break;
+		result += String.fromCodePoint(point);
+		index += point > 0xffff ? 2 : 1;
+		visible++;
+	}
+	return `${result}\u001b[0m`;
+}
+
+export function clearUsage(ctx: UiContext): void {
+	ctx.ui.setStatus("cliproxy-usage", undefined);
+	ctx.ui.setWidget("cliproxy-usage", undefined);
+}
+
+export function renderUsage(ctx: UiContext, items: AccountUsage[]): void {
+	ctx.ui.setStatus("cliproxy-usage", undefined);
+	if (!items.length) {
+		ctx.ui.setWidget("cliproxy-usage", undefined);
+		return;
+	}
+	ctx.ui.setWidget(
+		"cliproxy-usage",
+		(_tui: unknown, theme: Theme) => ({
+			invalidate() {},
+			render(width: number): string[] {
+				return items.map((item) => {
+					const providerColor =
+						item.provider === "claude"
+							? "warning"
+							: item.provider === "codex"
+								? "success"
+								: "accent";
+					const separator = theme.fg("dim", " │ ");
+					const prefix =
+						theme.fg(providerColor, `● ${PROVIDER_LABELS[item.provider]}`) +
+						separator +
+						theme.fg("muted", accountLabel(item.label)) +
+						separator;
+					if (item.error) {
+						return truncateAnsi(
+							`${prefix}${theme.fg("error", `! ${item.error}`)}`,
+							width,
+						);
+					}
+					const meter = (name: string, usage: UsageWindow) => {
+						const used = Math.max(0, Math.min(100, usage.used));
+						const color =
+							used >= 90 ? "error" : used >= 70 ? "warning" : "success";
+						const filled = usageBar(used).replace(/░+$/, "");
+						const empty = "░".repeat(10 - filled.length);
+						return `${theme.fg("muted", name)} ${theme.fg(color, filled)}${theme.fg("dim", empty)} ${theme.fg(color, `${Math.round(used)}%`)}`;
+					};
+					const windows = [
+						item.session && meter("S", item.session),
+						item.weekly && meter("W", item.weekly),
+					].filter(Boolean);
+					return truncateAnsi(
+						`${prefix}${windows.join(theme.fg("dim", "  │  "))}`,
+						width,
+					);
+				});
+			},
+		}),
+		{ placement: "belowEditor" },
+	);
+}

package/src/usage.ts

@@ -1,131 +1,131 @@
-import { readFile, readdir } from "node:fs/promises";
-import { homedir } from "node:os";
-import { basename, join, resolve } from "node:path";
-import { parseClaude, parseCodex, parseGrok, toNumber } from "./parsers.js";
-import type { AccountUsage, Config, ProviderName } from "./types.js";
-
-type AuthFile = {
-	type?: string;
-	email?: string;
-	access_token?: string;
-	account_id?: string;
-	disabled?: boolean;
-};
-
-const PROVIDERS = new Set<ProviderName>(["claude", "codex", "grok"]);
-const USAGE_URLS = {
-	claude: "https://api.anthropic.com/api/oauth/usage",
-	codex: "https://chatgpt.com/backend-api/wham/usage",
-	grok: "https://cli-chat-proxy.grok.com/v1/billing?format=credits",
-} as const;
-
-function expandHome(path: string): string {
-	if (path === "~") return homedir();
-	if (path.startsWith("~/") || path.startsWith("~\\")) {
-		return join(homedir(), path.slice(2));
-	}
-	return resolve(path);
-}
-
-function providerName(type?: string): ProviderName | undefined {
-	const provider = type === "xai" ? "grok" : type;
-	return PROVIDERS.has(provider as ProviderName)
-		? (provider as ProviderName)
-		: undefined;
-}
-
-async function request(
-	url: string,
-	token: string,
-	headers: Record<string, string> = {},
-): Promise<{ body: unknown; headers: Headers }> {
-	const response = await fetch(url, {
-		headers: {
-			Authorization: `Bearer ${token}`,
-			Accept: "application/json",
-			"User-Agent": "pi-cliproxy-usage",
-			...headers,
-		},
-		signal: AbortSignal.timeout(10_000),
-	});
-	if (!response.ok) throw new Error(`HTTP ${response.status}`);
-	return { body: await response.json(), headers: response.headers };
-}
-
-async function fetchUsage(
-	provider: ProviderName,
-	auth: AuthFile,
-	file: string,
-): Promise<AccountUsage> {
-	const label =
-		auth.email || basename(file, ".json").replace(/^(claude|codex|xai)-/, "");
-	try {
-		if (!auth.access_token) throw new Error("missing access_token");
-		if (provider === "claude") {
-			const { body } = await request(USAGE_URLS.claude, auth.access_token, {
-				"anthropic-beta": "oauth-2025-04-20",
-				"Content-Type": "application/json",
-			});
-			return { provider, label, ...parseClaude(body) };
-		}
-		if (provider === "codex") {
-			const headers: Record<string, string> = {};
-			if (auth.account_id) headers["ChatGPT-Account-Id"] = auth.account_id;
-			const response = await request(
-				USAGE_URLS.codex,
-				auth.access_token,
-				headers,
-			);
-			const parsed = parseCodex(response.body);
-			if (!parsed.session) {
-				const used = toNumber(
-					response.headers.get("x-codex-primary-used-percent"),
-				);
-				if (used !== undefined) parsed.session = { used };
-			}
-			return { provider, label, ...parsed };
-		}
-		const { body } = await request(USAGE_URLS.grok, auth.access_token, {
-			"X-XAI-Token-Auth": "xai-grok-cli",
-		});
-		return { provider, label, ...parseGrok(body) };
-	} catch (error) {
-		return {
-			provider,
-			label,
-			error: error instanceof Error ? error.message : String(error),
-		};
-	}
-}
-
-async function readAccount(
-	dir: string,
-	name: string,
-	config: Config,
-): Promise<AccountUsage | undefined> {
-	try {
-		const file = join(dir, name);
-		const auth = JSON.parse(await readFile(file, "utf8")) as AuthFile;
-		const provider = providerName(auth.type);
-		if (!provider || auth.disabled || !config.providers[provider])
-			return undefined;
-		return fetchUsage(provider, auth, file);
-	} catch {
-		return undefined;
-	}
-}
-
-export async function readAccounts(config: Config): Promise<AccountUsage[]> {
-	const dir = expandHome(config.accountsDir);
-	try {
-		const names = (await readdir(dir)).filter((name) =>
-			name.toLowerCase().endsWith(".json"),
-		);
-		const accounts = await Promise.all(
-			names.map((name) => readAccount(dir, name, config)),
-		);
-		return accounts.filter(Boolean) as AccountUsage[];
-	} catch {
-		return [];
-	}
-}
+import { readFile, readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { parseClaude, parseCodex, parseGrok, toNumber } from "./parsers.js";
+import type { AccountUsage, Config, ProviderName } from "./types.js";
+
+type AuthFile = {
+	type?: string;
+	email?: string;
+	access_token?: string;
+	account_id?: string;
+	disabled?: boolean;
+};
+
+const PROVIDERS = new Set<ProviderName>(["claude", "codex", "grok"]);
+const USAGE_URLS = {
+	claude: "https://api.anthropic.com/api/oauth/usage",
+	codex: "https://chatgpt.com/backend-api/wham/usage",
+	grok: "https://cli-chat-proxy.grok.com/v1/billing?format=credits",
+} as const;
+
+function expandHome(path: string): string {
+	if (path === "~") return homedir();
+	if (path.startsWith("~/") || path.startsWith("~\\")) {
+		return join(homedir(), path.slice(2));
+	}
+	return resolve(path);
+}
+
+function providerName(type?: string): ProviderName | undefined {
+	const provider = type === "xai" ? "grok" : type;
+	return PROVIDERS.has(provider as ProviderName)
+		? (provider as ProviderName)
+		: undefined;
+}
+
+async function request(
+	url: string,
+	token: string,
+	headers: Record<string, string> = {},
+): Promise<{ body: unknown; headers: Headers }> {
+	const response = await fetch(url, {
+		headers: {
+			Authorization: `Bearer ${token}`,
+			Accept: "application/json",
+			"User-Agent": "pi-cliproxy-usage",
+			...headers,
+		},
+		signal: AbortSignal.timeout(10_000),
+	});
+	if (!response.ok) throw new Error(`HTTP ${response.status}`);
+	return { body: await response.json(), headers: response.headers };
+}
+
+async function fetchUsage(
+	provider: ProviderName,
+	auth: AuthFile,
+	file: string,
+): Promise<AccountUsage> {
+	const label =
+		auth.email || basename(file, ".json").replace(/^(claude|codex|xai)-/, "");
+	try {
+		if (!auth.access_token) throw new Error("missing access_token");
+		if (provider === "claude") {
+			const { body } = await request(USAGE_URLS.claude, auth.access_token, {
+				"anthropic-beta": "oauth-2025-04-20",
+				"Content-Type": "application/json",
+			});
+			return { provider, label, ...parseClaude(body) };
+		}
+		if (provider === "codex") {
+			const headers: Record<string, string> = {};
+			if (auth.account_id) headers["ChatGPT-Account-Id"] = auth.account_id;
+			const response = await request(
+				USAGE_URLS.codex,
+				auth.access_token,
+				headers,
+			);
+			const parsed = parseCodex(response.body);
+			if (!parsed.session) {
+				const used = toNumber(
+					response.headers.get("x-codex-primary-used-percent"),
+				);
+				if (used !== undefined) parsed.session = { used };
+			}
+			return { provider, label, ...parsed };
+		}
+		const { body } = await request(USAGE_URLS.grok, auth.access_token, {
+			"X-XAI-Token-Auth": "xai-grok-cli",
+		});
+		return { provider, label, ...parseGrok(body) };
+	} catch (error) {
+		return {
+			provider,
+			label,
+			error: error instanceof Error ? error.message : String(error),
+		};
+	}
+}
+
+async function readAccount(
+	dir: string,
+	name: string,
+	config: Config,
+): Promise<AccountUsage | undefined> {
+	try {
+		const file = join(dir, name);
+		const auth = JSON.parse(await readFile(file, "utf8")) as AuthFile;
+		const provider = providerName(auth.type);
+		if (!provider || auth.disabled || !config.providers[provider])
+			return undefined;
+		return fetchUsage(provider, auth, file);
+	} catch {
+		return undefined;
+	}
+}
+
+export async function readAccounts(config: Config): Promise<AccountUsage[]> {
+	const dir = expandHome(config.accountsDir);
+	try {
+		const names = (await readdir(dir)).filter((name) =>
+			name.toLowerCase().endsWith(".json"),
+		);
+		const accounts = await Promise.all(
+			names.map((name) => readAccount(dir, name, config)),
+		);
+		return accounts.filter(Boolean) as AccountUsage[];
+	} catch {
+		return [];
+	}
+}