open-usage 0.3.2 → 0.5.0

package/README.md

@@ -74,7 +74,7 @@ open-usage --help
 | `↵`     | open the selected provider                      |
 | `m`     | overview mode: simplified / detailed            |
 | `w`     | window: session / weekly (simplified mode only) |
-| `t`     | cycle range: today / 7d / 30d / month / all     |
+| `t`     | cycle range: today / 7d / 30d / month           |
 | `r`     | refresh all providers                           |
 | `/`     | filter providers by name                        |
 | `o`     | re-run the setup wizard                         |
@@ -105,9 +105,28 @@ The check runs at most once a day, and [Configuration](#configuration) below cov
 Those three are what ships today.
 More providers are planned, so if a plan you pay for is missing, [open an issue](https://github.com/arionrefat/open-usage/issues) and say which one.
 
+### Spend
+
+The Claude Code screen also answers what a month cost, and where the money went.
+
+Where Claude reports real money it is used as-is: `~/.claude.json` carries the account's credit spend, the monthly cap, and the remaining balance.
+That figure is labelled `exact` and is never recomputed.
+
+Where Claude reports no money - a subscription with usage credits switched off - the tokens are priced against a shipped rate table and the figure is labelled `est`, alongside the date the prices were taken.
+Override any rate in `~/.config/open-usage/pricing.json`; a model with no published price is listed as unpriced rather than counted as free.
+
+The per-model split is an apportionment, not a second opinion.
+When an exact total covers the same window, each model's share is scaled to it, so the rows always add up to the headline and a stale price can move the split but never the total.
+
+Claude keeps neither history: transcripts are pruned at `cleanupPeriodDays` (30 by default) and the account block reports only the window you are in.
+So `open-usage` keeps its own record in `~/.config/open-usage/spend-history.json`, written from the day it is first run.
+Month one answers this month; by month four it answers all four.
+A month from before that file existed is shown as not recorded, never as zero.
+
 `open-usage` is read-only, and there is no account to create and no key to paste.
 It reuses the logins your CLIs already have: Claude and Codex limits come from their own signed-in CLIs, so their credentials are never read.
 The one credential file it opens is OpenCode's `auth.json`, and only to show connection status - the key is masked on read and never displayed, logged, or sent anywhere.
+It also reads `~/.claude.json`, but only the `cachedUsageUtilization` block Claude Code caches there, which is how the spend figures stay first-party; nothing else in that file is parsed, and no token in it is read.
 
 Nothing is written outside its own config directory, and there is no telemetry or analytics of any kind.
 It makes two outbound requests of its own accord.

package/bin/open-usage.js

@@ -3,7 +3,9 @@
 // The binary embeds Bun, so nothing needs to be installed alongside it.
 // Deliberately dependency-free and syntax-conservative so it runs on any Node.
 import { createRequire } from "node:module";
-import { spawnSync } from "node:child_process";
+import { spawn } from "node:child_process";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 
 const PLATFORM_PACKAGES = {
   "darwin-arm64": "@open-usage/darwin-arm64",
@@ -44,13 +46,42 @@ function resolvePlatformBinary() {
   }
 }
 
-const result = spawnSync(resolvePlatformBinary(), process.argv.slice(2), { stdio: "inherit" });
+export function launch(binary = resolvePlatformBinary(), args = process.argv.slice(2)) {
+  const child = spawn(binary, args, { stdio: "inherit" });
+  const signals = ["SIGTERM", "SIGINT", "SIGHUP"];
+  const handlers = new Map();
 
-if (result.error) {
-  fail("failed to start the platform binary", result.error.message);
-}
-// Mirror the child's termination so shells and CI see the real outcome.
-if (result.signal) {
-  process.kill(process.pid, result.signal);
+  function cleanup() {
+    for (const [signal, handler] of handlers) process.off(signal, handler);
+  }
+
+  for (const signal of signals) {
+    const handler = () => {
+      try {
+        child.kill(signal);
+      } catch {
+        // The child may already be exiting; its exit event remains authoritative.
+      }
+    };
+    handlers.set(signal, handler);
+    process.on(signal, handler);
+  }
+
+  child.once("error", (error) => {
+    cleanup();
+    fail("failed to start the platform binary", error.message);
+  });
+  child.once("exit", (code, signal) => {
+    cleanup();
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
 }
-process.exit(result.status ?? 1);
+
+if (
+  process.argv[1] &&
+  realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])
+) launch();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-usage",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "A terminal dashboard for unified AI plan usage across Claude Code, Codex, and OpenCode Go",
   "type": "module",
   "license": "GPL-3.0-only",
@@ -41,6 +41,7 @@
     "shot": "bun scripts/shot.tsx",
     "build": "bun build --compile --minify src/index.tsx --outfile dist/open-usage",
     "build:npm": "bun scripts/build-npm-packages.ts",
+    "prepublishOnly": "bun scripts/check-prepublish.ts",
     "version:set": "bun scripts/set-version.ts",
     "test": "bun test",
     "typecheck": "tsc --noEmit"
@@ -54,10 +55,10 @@
     "typescript": "^5"
   },
   "optionalDependencies": {
-    "@open-usage/darwin-arm64": "0.3.2",
-    "@open-usage/linux-arm64": "0.3.2",
-    "@open-usage/linux-x64": "0.3.2",
-    "@open-usage/win32-arm64": "0.3.2",
-    "@open-usage/win32-x64": "0.3.2"
+    "@open-usage/darwin-arm64": "0.5.0",
+    "@open-usage/linux-arm64": "0.5.0",
+    "@open-usage/linux-x64": "0.5.0",
+    "@open-usage/win32-arm64": "0.5.0",
+    "@open-usage/win32-x64": "0.5.0"
   }
 }