savemytokens 0.2.1 → 0.2.3

package/README.md

@@ -6,6 +6,8 @@
 
 ### Decide which projects get your Claude allowance.
 
+<sub>A capacity scheduler for Claude Code · Node 18.17+ · nothing leaves your machine</sub>
+
 <a href="https://www.npmjs.com/package/savemytokens"><img src="https://img.shields.io/npm/v/savemytokens?style=flat-square&color=1a7f37&label=npm" alt="npm version"></a>
 <img src="https://img.shields.io/badge/dependencies-0-1a7f37?style=flat-square" alt="zero dependencies">
 <img src="https://img.shields.io/badge/node-%E2%89%A5%2018.17-2b7489?style=flat-square" alt="node 18.17+">
@@ -71,7 +73,7 @@ burningdemand, because it is the only project on the high tier.
 
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/example.svg" alt="Seven projects in the ACTIVE table. Three are pinned, in the order they were pinned: burningdemand at 20% and 71% through it on HIGH, autonomykernel at 18% and 44% through, coldverdict at 12% and 93% through on LOW. Below them the unpinned ones share what is left." width="730">
+<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/example.svg" alt="Seven projects in the ACTIVE table. Three are pinned, in the order they were pinned: burningdemand at 20% and 71% through it on HIGH, autonomykernel at 18% and 44% through, coldverdict at 12% and 93% through on LOW. Below them the unpinned ones share what is left." width="955">
 
 </div>
 
@@ -83,20 +85,11 @@ them. Nothing here required you to guess how many tokens anything costs.
 
 ## Commands
 
-| | |
-| :-- | :-- |
-| `npx savemytokens` | the control centre |
-| `npx savemytokens status` | one plain-text snapshot · `--json` for a script |
-| `npx savemytokens share buydiff 40` | pin a project's allocation |
-| `npx savemytokens priority buydiff high` | who gets spare capacity first |
-| `npx savemytokens release buydiff` | hand its unused share back |
-| `npx savemytokens policy strict` | wind down earlier when it gets tight |
-| `npx savemytokens hud` | pick a status line, previewed on your numbers |
-| `npx savemytokens theme` | eighteen themes, or write your own |
-| `npx savemytokens defer` | work a session pushed to next time |
-| `npx savemytokens audit` | what your last 7 days wasted |
-| `npx savemytokens privacy` | every file it reads and writes |
-| `npx savemytokens uninstall` | remove every trace · `--purge` drops the data too |
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/commands.svg" alt="The command list: npx savemytokens for the control centre, status, share, priority, release, policy, hud, theme, defer, audit, privacy and uninstall." width="955">
+
+</div>
 
 `--codex` points any of these at Codex instead, which publishes its own rate limits and needs no
 hooks. It is metered and shown, but nothing can be injected into it, so there is no advice.
@@ -198,9 +191,9 @@ bar the built-in themes have to clear.
   beyond those two facts would be a guess dressed up as a number.
 - **It cannot see usage it did not measure.** Another machine, claude.ai, or work done before you
   installed it shows up as unattributed window, labelled as such.
-- **An idle window still holds its share.** A session with nothing running keeps its slice rather
-  than lending it out, so ten open terminals divide the window ten ways. Treating a target as a
-  weight among sessions actually consuming is the next fix.
+- **The split moves under you.** A window that has taken no turn in ten minutes lends its share to
+  the rest, and takes it back the moment you type in it again. What is on screen is the current
+  split, not a contract: a project's allocation can change without you touching anything.
 - **It makes no network call.** No account, no telemetry, no daemon. `savemytokens privacy` prints
   every file it reads and writes.
 

package/dist/commands/install.js

@@ -105,6 +105,9 @@ function writeRules() {
 export function rulesInstalled() {
     return readMemory().includes(RULES_START);
 }
+export function claudeCodeFound() {
+    return fs.existsSync(CLAUDE_HOME) || fs.existsSync(SETTINGS);
+}
 export function hookInstalled() {
     return fs.existsSync(hookPath("hook.mjs"));
 }
@@ -140,6 +143,7 @@ export function runInstall(options) {
         process.exitCode = 1;
         return;
     }
+    const foundClaudeCode = claudeCodeFound();
     const settings = parsed;
     const existingStatusLine = settings.statusLine?.command;
     const ours = ourCommand(existingStatusLine);
@@ -223,6 +227,12 @@ export function runInstall(options) {
     writeSettings(settings);
     out.push(`${green("Installed.")} It takes effect in sessions you start from now on.`);
     out.push(dim("  Open the control centre with: npx savemytokens"));
+    if (!foundClaudeCode) {
+        out.push("");
+        out.push(yellow("  Claude Code was not found."));
+        out.push(dim(`  Nothing was seen at ${CLAUDE_HOME}, so this machine may not have it installed.`));
+        out.push(dim("  The hooks are in place and will start working the first time you run it."));
+    }
     out.push("");
     if (!options.quiet)
         process.stdout.write(out.join("\n") + "\n");

package/dist/report/views.js

@@ -419,7 +419,7 @@ export function helpOverlay(control, context) {
     out.push(...helpSection("the status line", context));
     out.push(...helpProse(control.installed
         ? "Installed. It is the only place your 5h and 7d usage is published, and it is what proves a session is still open, so without it nothing here is live. Change its shape with P."
-        : "Not installed, so nothing here is live. It is the only place your 5h and 7d usage is publishes your 5h and 7d usage, and it is what proves a session is still open. Run: npx savemytokens install", context));
+        : "Not installed, so nothing here is live. It is the only place your 5h and 7d usage is published, and it is what proves a session is still open. Run: npx savemytokens install", context));
     out.push(...helpSection("the numbers", context));
     out.push(...helpProse("5h and 7d are published figures, not ours. Share is measured from the tokens in your transcripts. Used of it is their number split by that share, so the split between rows is ours, not theirs.", context));
     const drift = control.unattributed ?? 0;

package/dist/runtime/kernel.mjs

@@ -684,21 +684,30 @@ export function usageInWindow(record, from, to) {
   return { ...total, tokens, weighted };
 }
 
+const isPinned = (entry) => typeof entry.share === "number" && entry.share >= 0;
+const isRunning = (entry) => entry.state === "active" || entry.state === "needs-more";
+const holdsAClaim = (entry) => isRunning(entry) || isPinned(entry) || (entry.consumed || 0) > 0;
+
 export function allocate(entries) {
   const targets = new Map();
   const eligible = [];
   let reserved = 0;
   let released = 0;
 
+  const claiming = entries.filter(holdsAClaim);
+  const pinnedClaims = claiming.reduce((sum, entry) => (isPinned(entry) ? sum + entry.share : sum), 0);
+  const openClaims = claiming.filter((entry) => !isPinned(entry)).length;
+  const evenClaim = openClaims > 0 ? Math.max(0, 1 - Math.min(1, pinnedClaims)) / openClaims : 0;
+
   for (const entry of entries) {
-    const state = entry.state;
-    if (state === "active" || state === "needs-more") {
+    if (isRunning(entry)) {
       eligible.push(entry);
       continue;
     }
     const keep = Math.max(0, Math.min(1, entry.consumed || 0));
+    const nominal = isPinned(entry) ? entry.share : holdsAClaim(entry) ? evenClaim : 0;
     reserved += keep;
-    if (typeof entry.share === "number" && entry.share > keep) released += entry.share - keep;
+    if (nominal > keep) released += nominal - keep;
     targets.set(entry.id, { claimantId: entry.id, target: keep, pinned: false, pool: 0, released: true });
   }
 
@@ -712,8 +721,8 @@ export function allocate(entries) {
   let budget = Math.max(0, 1 - Math.min(1, reserved));
   if (eligible.length === 0) return { targets, unusedPool: budget };
 
-  const pinned = eligible.filter((entry) => typeof entry.share === "number" && entry.share >= 0);
-  const free = eligible.filter((entry) => !(typeof entry.share === "number" && entry.share >= 0));
+  const pinned = eligible.filter(isPinned);
+  const free = eligible.filter((entry) => !isPinned(entry));
   const pinnedSum = pinned.reduce((sum, entry) => sum + entry.share, 0);
   const scale = pinnedSum > budget && pinnedSum > 0 ? budget / pinnedSum : 1;
 
@@ -941,15 +950,16 @@ export function viewFor(plan, id) {
   return plan.claimants.find((view) => view.claimant.id === id) ?? null;
 }
 
-const MIN_TARGET = 0.001;
 const MAX_PRESSURE = 9.99;
 
 export function pressureFor(consumedShare, target, quotaUsedPercent) {
-  if (!(target > MIN_TARGET)) return { value: consumedShare > 0 ? MAX_PRESSURE : 0, basis: "share" };
+  const spent = consumedShare > 0 ? consumedShare : 0;
+  if (!(target > 0)) return { value: spent > 0 ? MAX_PRESSURE : 0, basis: "share" };
+  const ratio = spent / target;
   if (typeof quotaUsedPercent === "number" && quotaUsedPercent >= 0) {
-    return { value: Math.min(MAX_PRESSURE, (quotaUsedPercent / 100) * (consumedShare / target)), basis: "budget" };
+    return { value: Math.min(MAX_PRESSURE, (quotaUsedPercent / 100) * ratio), basis: "budget" };
   }
-  return { value: Math.min(MAX_PRESSURE, consumedShare / target), basis: "share" };
+  return { value: Math.min(MAX_PRESSURE, ratio), basis: "share" };
 }
 
 export const POLICIES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "savemytokens",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Give every Claude Code session a target share of your Claude window, and keep Claude aware of it. Local, private, zero setup.",
   "keywords": [
     "claude",
@@ -40,8 +40,11 @@
     "build": "tsc -p tsconfig.json && node scripts/copy-runtime.mjs",
     "dev": "npm run build && node dist/cli.js",
     "test": "npm run build && node --test test/*.test.js",
-    "screenshot": "npm run build && COLORTERM=truecolor node scripts/screenshot.mjs",
-    "prepublishOnly": "npm run build && npm test"
+    "screenshot": "npm run build && COLORTERM=truecolor node scripts/screenshot.mjs && rsvg-convert -w 1280 -h 640 assets/social.svg -o assets/social.png && cp assets/social.png web/og-image.png && cp assets/screenshot.svg assets/statusline.svg assets/f-numbers.svg assets/f-share.svg assets/f-agent.svg assets/f-resting.svg assets/f-defer.svg web/ && node scripts/stamp-assets.mjs",
+    "prepublishOnly": "npm run build && npm test",
+    "postpublish": "node scripts/release.mjs",
+    "release": "node scripts/release.mjs",
+    "drift": "node scripts/drift.mjs"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",