@dylanpiercey/work 0.0.39 → 0.0.40

package/README.md

@@ -50,6 +50,14 @@ For a production build plus a background service (systemd on Linux, launchd on m
 
 ```sh
 ./scripts/setup-prod.sh   # build + install + start the service
+
+# While hacking on work itself, point the background service at a checkout
+# (and back at the npm install when done):
+cp scripts/work-source.sh ~/.local/bin/work-source && chmod +x ~/.local/bin/work-source
+work-source local          # this tree (or: work-source local /path/to/work)
+work-source rebuild        # rebuild + restart without rewriting the unit
+work-source prod           # global @dylanpiercey/work again
+work-source                # status
 ./scripts/run-prod.sh     # or: build with --no-service and run manually
 ./scripts/update.sh       # later: pull latest, rebuild, restart
 ```
@@ -86,7 +94,9 @@ surrounding environment still takes precedence:
 WORK_BRANCH_PREFIX=rturnq
 ```
 
-Optional: a `plan-usage` CLI on PATH enables the agent plan/quota usage panel.
+The usage panel (and `work usage`) reads plan/quota windows straight from each
+agent CLI's own credentials on disk — Claude, Codex, Cursor, Grok, and Copilot
+(via `gh`'s token). Providers you are not signed into simply say so.
 
 PR chips refresh by polling GitHub (faster for a few minutes after a
 local push via `repo-pushed`). No inbound GitHub webhooks are required.

package/bin/work.mjs

@@ -4,6 +4,7 @@
 //   work setup    install/refresh the background service (+ optional tunnel)
 //   work start    run the server in the foreground
 //   work update   upgrade the npm package and refresh the service
+//   work usage    print agent plan/quota usage
 //   work version  print the installed version
 import { execFileSync, spawnSync } from "node:child_process";
 import fs from "node:fs";
@@ -43,6 +44,9 @@ switch (command) {
   case "update":
     await update();
     break;
+  case "usage":
+    await usage();
+    break;
   case "version":
   case "--version":
   case "-v":
@@ -50,7 +54,7 @@ switch (command) {
     break;
   default:
     console.log(
-      `work ${pkg.version}\n\nusage: work <setup|start|update|version>`,
+      `work ${pkg.version}\n\nusage: work <setup|start|update|usage|version>`,
     );
 }
 
@@ -60,6 +64,77 @@ async function start() {
   await import(distEntry);
 }
 
+/** Plan/quota usage, read from the running server.
+ *
+ * The collector lives in the server bundle (src/server/usage/) so the page and
+ * this table can never disagree, which is also why this asks over HTTP instead
+ * of re-reading every provider's credentials itself. */
+async function usage() {
+  const port = serviceEnv().PORT;
+  const url = `http://127.0.0.1:${port}/api/usage${args.includes("--refresh") ? "?refresh" : ""}`;
+  let data;
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+    if (!res.ok) die(`server answered ${res.status} for /api/usage`);
+    data = await res.json();
+  } catch {
+    die(`no work server on port ${port} — start one with: work start`);
+  }
+  if (args.includes("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (data.error) die(data.error);
+  const agents = data.agents || [];
+  if (!agents.length) return console.log("no agent accounts found");
+  for (const agent of agents) {
+    const head = [agent.agent, agent.plan?.replace(/^default_/, "").replaceAll("_", " "), agent.account]
+      .filter(Boolean)
+      .join("  ·  ");
+    console.log(`\n${head}`);
+    for (const win of agent.windows || []) {
+      const pct = Math.max(0, Math.min(100, win.used_percent));
+      const filled = Math.round(pct / 10);
+      const bar = "█".repeat(filled) + "░".repeat(10 - filled);
+      const resets = until(win.resets_at);
+      console.log(
+        `  ${win.window.padEnd(5)} ${bar} ${pctText(win.used_percent).padStart(5)}${resets ? `  ↻ ${resets}` : ""}`,
+      );
+    }
+    // Only reason a row can be empty or wrong, so it goes last and unindented
+    // enough to read as a warning rather than another window.
+    if (agent.note) console.log(`  ⚠ ${agent.note}`);
+    if (agent.stale_seconds != null) {
+      console.log(`  ⚠ ${short(agent.stale_seconds * 1000)} old`);
+    }
+  }
+}
+
+/** "4h" / "6d" — how long until an ISO timestamp. A reset already in the past
+ * means the window turned over and this row hasn't refreshed since, so there
+ * is no honest countdown to print. */
+function until(iso) {
+  if (!iso) return null;
+  const ms = new Date(iso).getTime() - Date.now();
+  return ms > 0 ? short(ms) : null;
+}
+
+/** Percent, with a decimal only where rounding would lie: 99.6% must not
+ * read as a spent 100%, and 0.4% must not read as an untouched 0%. */
+function pctText(pct) {
+  const rounded = Math.round(pct);
+  return rounded !== pct && (rounded === 100 || rounded === 0)
+    ? `${pct.toFixed(1)}%`
+    : `${rounded}%`;
+}
+
+function short(ms) {
+  const m = Math.round(ms / 60_000);
+  if (m < 60) return `${m}m`;
+  const h = Math.round(m / 60);
+  return h < 48 ? `${h}h` : `${Math.round(h / 24)}d`;
+}
+
 async function setup() {
   // Runtime tools. The curl installer normally provides these; a plain
   // `npm i -g` user may be missing them.