tokmon 0.9.1 → 0.10.0

package/README.md

@@ -73,6 +73,7 @@ Then just run `tokmon`. Press `q` to quit.
 - **Today / This Week / This Month** — cost and token summaries
 - **Burn rate** — current $/hr
 - **Rate Limits** — real-time session (5h), weekly (7d), and Sonnet utilization with reset countdowns, fetched from Anthropic's OAuth API
+- **Peak / Off-Peak badge** — shown in the header, fetched from [promoclock.co](https://promoclock.co) (peak hours drain session limits faster)
 
 ### Table
 
@@ -96,7 +97,8 @@ Sort by date or cost with `o`.
 
 Press `s` to open. Persisted to `~/.config/tokmon/config.json` (macOS/Linux) or `%APPDATA%\tokmon\config.json` (Windows).
 
-- **Refresh interval** — adjust with `←` `→`
+- **Refresh interval** — dashboard poll rate (default: 2s)
+- **Billing poll** — rate limits API poll rate (default: 5m, min 1m to avoid 429s)
 - **Clear screen** — clears terminal on launch (like `watch`)
 
 ## How It Works

package/dist/cli.js

@@ -8,7 +8,7 @@ import { MouseProvider } from "@zenobius/ink-mouse";
 import { readFile, writeFile, mkdir } from "fs/promises";
 import { join } from "path";
 import { homedir } from "os";
-var DEFAULTS = { interval: 2, clearScreen: true };
+var DEFAULTS = { interval: 2, billingInterval: 5, clearScreen: true };
 function configDir() {
   if (process.platform === "win32") {
     return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "tokmon");
@@ -297,10 +297,18 @@ async function getAccessToken() {
   }
   return readCredentialsFile();
 }
-var EMPTY = { session: null, weekly: null, sonnet: null, extraUsage: null, error: null };
+var EMPTY = { session: null, weekly: null, sonnet: null, extraUsage: null, peak: null, error: null };
 async function fetchBilling() {
   const token = await getAccessToken();
   if (!token) return { ...EMPTY, error: "No OAuth token \u2014 run claude and log in" };
+  const [usageRes, peak] = await Promise.all([
+    fetchUsage(token),
+    fetchPeakStatus()
+  ]);
+  if ("error" in usageRes) return { ...EMPTY, peak, error: usageRes.error };
+  return { ...usageRes.data, peak, error: null };
+}
+async function fetchUsage(token) {
   try {
     const res = await fetch("https://api.anthropic.com/api/oauth/usage", {
       headers: {
@@ -310,31 +318,54 @@ async function fetchBilling() {
       },
       signal: AbortSignal.timeout(1e4)
     });
-    if (res.status === 429) return { ...EMPTY, error: "Rate limited \u2014 retrying in 2m" };
-    if (res.status === 401) return { ...EMPTY, error: "Token expired \u2014 restart Claude Code" };
-    if (!res.ok) return { ...EMPTY, error: `API ${res.status}` };
+    if (res.status === 429) return { error: "Rate limited \u2014 retrying next poll" };
+    if (res.status === 401) return { error: "Token expired \u2014 restart Claude Code" };
+    if (!res.ok) return { error: `API ${res.status}` };
+    const data = await res.json();
+    return {
+      data: {
+        session: data.five_hour ? {
+          utilization: data.five_hour.utilization,
+          resetsAt: formatReset(data.five_hour.resets_at)
+        } : null,
+        weekly: data.seven_day ? {
+          utilization: data.seven_day.utilization,
+          resetsAt: formatReset(data.seven_day.resets_at)
+        } : null,
+        sonnet: data.seven_day_sonnet ? {
+          utilization: data.seven_day_sonnet.utilization,
+          resetsAt: formatReset(data.seven_day_sonnet.resets_at)
+        } : null,
+        extraUsage: data.extra_usage?.is_enabled ? {
+          limit: data.extra_usage.monthly_limit / 100,
+          used: data.extra_usage.used_credits / 100
+        } : null
+      }
+    };
+  } catch {
+    return { error: "Network error" };
+  }
+}
+async function fetchPeakStatus() {
+  try {
+    const res = await fetch("https://promoclock.co/api/status", {
+      headers: { "Accept": "application/json", "User-Agent": "tokmon" },
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (!res.ok) return null;
     const data = await res.json();
+    let state;
+    if (data.isPeak === true || data.status === "peak") state = "peak";
+    else if (data.isWeekend === true || data.status === "weekend") state = "weekend";
+    else if (data.isOffPeak === true || data.status === "off_peak" || data.status === "off-peak") state = "off-peak";
+    else return null;
     return {
-      session: data.five_hour ? {
-        utilization: data.five_hour.utilization,
-        resetsAt: formatReset(data.five_hour.resets_at)
-      } : null,
-      weekly: data.seven_day ? {
-        utilization: data.seven_day.utilization,
-        resetsAt: formatReset(data.seven_day.resets_at)
-      } : null,
-      sonnet: data.seven_day_sonnet ? {
-        utilization: data.seven_day_sonnet.utilization,
-        resetsAt: formatReset(data.seven_day_sonnet.resets_at)
-      } : null,
-      extraUsage: data.extra_usage?.is_enabled ? {
-        limit: data.extra_usage.monthly_limit / 100,
-        used: data.extra_usage.used_credits / 100
-      } : null,
-      error: null
+      state,
+      label: state === "peak" ? "Peak" : state === "weekend" ? "Weekend" : "Off-Peak",
+      minutesUntilChange: typeof data.minutesUntilChange === "number" ? data.minutesUntilChange : null
     };
   } catch {
-    return { ...EMPTY, error: "Network error" };
+    return null;
   }
 }
 function formatReset(iso) {
@@ -387,7 +418,7 @@ var VIEWS = ["Daily", "Weekly", "Monthly"];
 var SORTS = ["date \u2191", "date \u2193", "cost \u2191", "cost \u2193"];
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 var MONTHS = ["", "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
-var DEFAULT_CONFIG = { interval: 2, clearScreen: true };
+var DEFAULT_CONFIG = { interval: 2, billingInterval: 5, clearScreen: true };
 var IS_TTY = process.stdin.isTTY === true;
 function App({ interval: cliInterval }) {
   const [dashboard, setDashboard] = useState(null);
@@ -438,6 +469,7 @@ function App({ interval: cliInterval }) {
       clearInterval(id);
     };
   }, [interval2]);
+  const billingMs = cfg.billingInterval * 6e4;
   useEffect(() => {
     let active = true;
     const load = () => fetchBilling().then((b) => {
@@ -445,12 +477,12 @@ function App({ interval: cliInterval }) {
     }).catch(() => {
     });
     load();
-    const id = setInterval(load, 12e4);
+    const id = setInterval(load, billingMs);
     return () => {
       active = false;
       clearInterval(id);
     };
-  }, []);
+  }, [billingMs]);
   useEffect(() => {
     if (tab !== 1) return;
     if (tableLoadedOnce.current && table) return;
@@ -503,23 +535,27 @@ function App({ interval: cliInterval }) {
     };
   }, [tab]);
   useInput((input, key) => {
+    if (input === "q") {
+      exit();
+      return;
+    }
     if (showSettings) {
       if (key.escape || input === "s") setShowSettings(false);
       if (key.upArrow) setSettingsCursor((c) => Math.max(0, c - 1));
-      if (key.downArrow) setSettingsCursor((c) => Math.min(1, c + 1));
+      if (key.downArrow) setSettingsCursor((c) => Math.min(2, c + 1));
       if (settingsCursor === 0) {
         if (key.leftArrow) updateConfig((c) => ({ ...c, interval: Math.max(1, c.interval - 1) }));
         if (key.rightArrow) updateConfig((c) => ({ ...c, interval: c.interval + 1 }));
       }
-      if (settingsCursor === 1 && (key.leftArrow || key.rightArrow || key.return)) {
+      if (settingsCursor === 1) {
+        if (key.leftArrow) updateConfig((c) => ({ ...c, billingInterval: Math.max(1, c.billingInterval - 1) }));
+        if (key.rightArrow) updateConfig((c) => ({ ...c, billingInterval: c.billingInterval + 1 }));
+      }
+      if (settingsCursor === 2 && (key.leftArrow || key.rightArrow || key.return)) {
         updateConfig((c) => ({ ...c, clearScreen: !c.clearScreen }));
       }
       return;
     }
-    if (input === "q") {
-      exit();
-      return;
-    }
     if (input === "s") {
       setShowSettings(true);
       return;
@@ -626,7 +662,13 @@ function App({ interval: cliInterval }) {
           "s"
         ] })
       ] }),
-      /* @__PURE__ */ jsx(Text, { dimColor: true, children: time(updated) })
+      /* @__PURE__ */ jsxs(Box, { children: [
+        billing?.peak && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(PeakBadge, { peak: billing.peak }),
+          /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  \xB7  " })
+        ] }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: time(updated) })
+      ] })
     ] }),
     showSettings ? /* @__PURE__ */ jsx(SettingsView, { config: cfg, cursor: settingsCursor }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
@@ -721,7 +763,7 @@ function SettingsView({ config: config2, cursor }) {
         cursor === 0 ? "\u25B8" : " ",
         " "
       ] }),
-      /* @__PURE__ */ jsx(Text, { children: "Refresh interval  " }),
+      /* @__PURE__ */ jsx(Text, { children: "Refresh interval    " }),
       /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
         "\u25C2",
         " "
@@ -740,7 +782,26 @@ function SettingsView({ config: config2, cursor }) {
         cursor === 1 ? "\u25B8" : " ",
         " "
       ] }),
-      /* @__PURE__ */ jsx(Text, { children: "Clear screen      " }),
+      /* @__PURE__ */ jsx(Text, { children: "Billing poll        " }),
+      /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+        "\u25C2",
+        " "
+      ] }),
+      /* @__PURE__ */ jsxs(Text, { bold: true, color: "yellow", children: [
+        config2.billingInterval,
+        "m"
+      ] }),
+      /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+        " ",
+        "\u25B8"
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsxs(Text, { color: cursor === 2 ? "green" : void 0, children: [
+        cursor === 2 ? "\u25B8" : " ",
+        " "
+      ] }),
+      /* @__PURE__ */ jsx(Text, { children: "Clear screen        " }),
       /* @__PURE__ */ jsx(Text, { bold: true, color: config2.clearScreen ? "green" : "red", children: config2.clearScreen ? "on" : "off" })
     ] }),
     /* @__PURE__ */ jsx(Box, { height: 1 }),
@@ -812,6 +873,24 @@ function DashboardView({ data, billing }) {
     )
   ] });
 }
+function PeakBadge({ peak }) {
+  const color = peak.state === "peak" ? "red" : "green";
+  return /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsx(Text, { color, children: "\u25CF " }),
+    /* @__PURE__ */ jsx(Text, { bold: true, color, children: peak.label }),
+    peak.minutesUntilChange !== null && peak.minutesUntilChange > 0 && /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+      " (",
+      fmtMinutes(peak.minutesUntilChange),
+      ")"
+    ] })
+  ] });
+}
+function fmtMinutes(mins) {
+  if (mins < 60) return `${mins}m`;
+  const h = Math.floor(mins / 60);
+  const m = mins % 60;
+  return m === 0 ? `${h}h` : `${h}h ${m}m`;
+}
 function LimitBar({ label, pct, resets }) {
   const width = 30;
   const filled = Math.round(pct / 100 * width);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokmon",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Terminal dashboard for Claude Code usage and costs",
   "type": "module",
   "bin": {