savemytokens 0.2.0 → 0.2.1

package/README.md

@@ -4,7 +4,7 @@
 
 # SaveMyTokens
 
-### Decide which project gets your Claude allowance.
+### Decide which projects get your Claude allowance.
 
 <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">
@@ -14,43 +14,73 @@
 
 <br><br>
 
-<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/screenshot.svg" alt="The SaveMyTokens control centre: three live projects sharing one 5-hour window, each row showing its allocation, how much of that allocation it has spent, its priority and its last prompt." width="880">
+<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/screenshot.svg" alt="The SaveMyTokens control centre: seven projects sharing one 5-hour window, three of them pinned to the top, each row showing its allocation, how much of that allocation it has spent, its priority and its last prompt, above a RECENT table of six more." width="955">
 
 <br>
 
-<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/statusline.svg" alt="A Claude Code status line: a braille bar, then 21%/50%, 5h 42%, in 3h52." width="520">
+<img src="https://raw.githubusercontent.com/offbeatport/savemytokens/main/assets/statusline.svg" alt="A Claude Code status line: a braille bar, then 42% of 50%, 5h 42%, resets in 3h52m." width="520">
 
 </div>
 
 <br>
 
+You have four Claude Code windows open. One of them is a throwaway experiment and it is quietly
+eating the afternoon, but there is one usage number for all four, so there is no way to know
+which. By the time the window is gone, the work that mattered is the work that did not finish.
+
 ## Get started
 
 ```sh
 npx savemytokens
 ```
 
-That is the whole install. It opens the control centre and, on the first run, offers to add four
-hooks and a status line to Claude Code's `settings.json`, backing the file up first. Prefer it
-installed once rather than fetched each time? `npm i -g savemytokens`, then the command is just
-`savemytokens`.
+That is the whole install. On the first run it offers to add four hooks and a status line to Claude
+Code's `settings.json`, backing the file up first.
 
-**Say yes.** The status line is the only place Anthropic publishes your 5h and weekly usage, and it
-is what proves a session is still open, so nothing is live without it. Changed your mind?
-`npx savemytokens uninstall` takes every entry back out.
+- **Say yes.** The status line is the only place your 5h and weekly usage is published, and it is
+  what proves a session is still open. Nothing is live without it.
+- **Don't want to see one?** Take **Install, no line**. Everything is installed and the line renders
+  nothing, so the numbers still arrive and your terminal looks unchanged.
+- **Rather not fetch it each time?** `npm i -g savemytokens`, then the command is just
+  `savemytokens`.
+- **Changed your mind?** `npx savemytokens uninstall` takes every entry back out.
 
 <br>
 
 |  |  |
 | :-- | :-- |
-| **The real numbers** | Your 5-hour and weekly usage exactly as Anthropic publishes it. Never an invented *"% remaining"*. |
-| **Two lists you control** | **ACTIVE** is what shares your window; **RECENT** is everything else it has seen. A project joins ACTIVE on its own when you open Claude Code there and stays after you close it, so a target survives the session. `a` moves one up, `x` sends it back. |
-| **Claude working to it** | As a session eats into its slice it is told to narrow scope and finish, and to write down whatever it drops. That comes back the next time you work on the project. |
-| **Unused capacity returned** | A project with nothing running lends its share to the rest and takes it back when you return. Mark one done and what it did not spend goes to the others immediately. |
-| **In your status line** | `21%/50% · 5h 42% · in 3h52`. How much of your share you have spent, where the window is, when it comes back. Pick a shape, or arrange the pieces yourself. |
+| **The real numbers** | Your 5-hour and weekly usage exactly as Claude Code publishes it to the status line. Never an invented *"% remaining"*. |
+| **A split you control** | Give each project a target and a priority. Move one and the others move to fit, so the window always adds up. |
+| **The agent working to it** | As a session eats into its slice it is told to narrow scope and finish, and to write down whatever it drops. That comes back the next time you open the project. |
+| **Capacity returned** | A project with nothing running lends its share to the rest and reclaims it when you come back. |
+| **In your status line** | `⣿⣿⣿⣿⣿⣀⣀⣀⣀⣀⣀⣀ 42% of 50% · 5h 42% · resets in 3h52m`. Pick a shape, arrange the pieces yourself, or run it silent. |
 
 <br>
 
+## A worked example
+
+Seven projects open, and the release matters more than the experiment.
+
+```sh
+npx savemytokens share burningdemand 20      # Set burningdemand target to 20%
+npx savemytokens priority burningdemand high # burningdemand now takes spare capacity first
+```
+
+The others split what is left. When one of them finishes, whatever it did not spend goes to
+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">
+
+</div>
+
+`coldverdict` is at 93% of its slice, so its next turn opens with a line telling it to finish what it
+has and write down the rest. Whatever it drops comes back the next time you open that project.
+
+The three pinned rows hold the order you pinned them in, whatever happens to the numbers beside
+them. Nothing here required you to guess how many tokens anything costs.
+
 ## Commands
 
 | | |
@@ -65,11 +95,21 @@ is what proves a session is still open, so nothing is live without it. Changed y
 | `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 |
 
-Inside the control centre, `?` lists every key. The ones worth knowing: `←→` moves an allocation,
-`space` moves a project up a level and `x` moves it down, so a project you never want to see goes
-ACTIVE to RECENT to hidden. `p` cycles priority, `⏎` opens a project's sessions, `s` opens settings.
+`--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.
+
+In a row, `★` means you pinned it and pinned rows keep the order you pinned them in; a number beside
+it is how many Claude Code windows are open in that project, shown only when there is more than one;
+a dimmed row is holding its share while nothing runs there.
+
+Inside the control centre, `?` lists every key. The ones worth knowing: **`←→` moves an allocation,
+and the others move to fit** so the window always adds up. `space` moves a project up a level and
+`x` moves it down, so one you never want to see goes ACTIVE to RECENT to hidden, and `m` shows what
+is hidden. `e` puts everything back to an even split, `p` cycles priority, `⏎` opens a project's
+sessions, `s` opens settings.
 
 ## Where the numbers come from
 
@@ -77,30 +117,35 @@ Three different kinds of number sit on that screen, and it matters which is whic
 
 | | |
 | :-- | :-- |
-| **5h and 7d** | Anthropic's own figures. Claude Code publishes them to the status line, so SaveMyTokens installs one, reads them, and stores each reading with its timestamp. Nothing is estimated. |
-| **share** | Measured from the transcripts already on your disk, token by token, including subagents. Exact, and independent of anything Anthropic reports. |
-| **used, allocation** | Anthropic's percentage, split by that measured share. The total is theirs. The division between projects is ours, and it is the only inferred number on the screen. |
+| **5h and 7d** | Published figures, not ours. Claude Code writes them to the status line, so SaveMyTokens installs one, reads them, and stores each reading with its timestamp. Nothing is estimated. |
+| **share** | Measured from the transcripts already on your disk, token by token, including subagents. Exact, and independent of anything the provider reports. |
+| **used, allocation** | The published percentage, split by that measured share. The total is not ours. The division between projects is ours, and it is the only inferred number on the screen. |
 
 Usage from another machine, or from claude.ai, is invisible to a local tool. When the window moves
-while none of your projects had a turn, that is reported on its own line rather than folded silently
-into a project's figure.
+across five minutes in which nothing local was metered, it is reported on its own line rather than
+folded silently into a project's figure.
 
 ## How it works
 
-`install` writes three scripts to `~/.savemytokens/hooks`, adds four hook entries and a status line
-to Claude Code's `settings.json`, and backs that file up first. There is no daemon. The hooks meter
-their own session as it runs, the status line captures the published window every ten seconds, and
-the control centre reads what they leave behind. Transcripts are read incrementally, from a stored
-byte offset per file, so a prompt costs milliseconds however long the session has run.
-
-Nothing outside `~/.savemytokens` and Claude Code's own settings is touched. `uninstall` puts it
-back, and restores a status line of your own if it wrapped one.
+- **No daemon.** Three scripts in `~/.savemytokens/hooks`, four hook entries and a status line in
+  Claude Code's `settings.json`, which is backed up first.
+- **The hooks meter their own session** as it runs. The status line captures the published window
+  every ten seconds. The control centre reads what they leave behind.
+- **Transcripts are read incrementally**, from a stored byte offset per file, so a prompt costs
+  milliseconds however long the session has run.
+- **Nothing else is touched.** `uninstall` puts it back, and restores a status line of your own if
+  it wrapped one.
 
 ## Requirements
 
-Node 18.17 or newer, and Claude Code 2.1 or newer. The published 5h and 7d figures come with a Claude
-subscription. On an API key or through the Console, Anthropic reports no window; SaveMyTokens says so
-rather than guessing, and allocation and advice still work from measured usage alone.
+- **Node 18.17 or newer**, and **Claude Code 2.1 or newer**.
+- **A Claude subscription** for the published 5h and 7d figures. On an API key or through the
+  Console no window is reported; SaveMyTokens says so rather than guessing, and allocation and
+  advice still work from measured usage alone.
+- **macOS** is what it is developed and tested on. **Linux** should behave identically. **Windows**
+  is written for but unproven: paths and the home directory resolve portably, and the control centre
+  wants a terminal that handles the alternate screen buffer, which Windows Terminal does. If it
+  misbehaves there, please [open an issue](https://github.com/offbeatport/savemytokens/issues/new).
 
 <details>
 <summary><b>Writing your own theme</b></summary>
@@ -149,10 +194,13 @@ bar the built-in themes have to clear.
 - **It advises; it does not enforce.** The hooks inject text, and a model does not hold a budget the
   way a scheduler holds a lock. A session that ignores the advice keeps running. Hard caps are the
   next step, and will ship only after a period of logging what *would* have been blocked.
-- **It does not predict a lockout.** Anthropic publishes a percentage and a reset time. Anything
+- **It does not predict a lockout.** A percentage and a reset time are published. Anything
   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.
 - **It makes no network call.** No account, no telemetry, no daemon. `savemytokens privacy` prints
   every file it reads and writes.
 

package/dist/cli-options.js

@@ -31,7 +31,6 @@ export function parseArgs(argv) {
         interval: 60,
         dryRun: false,
         force: false,
-        window: "five_hour",
         adapter: "claude-code",
         rules: false,
         purge: false,

package/dist/commands/audit.js

@@ -7,7 +7,7 @@ import { collect } from "../collect.js";
 import { renderAudit } from "../report/render.js";
 import { loadRuns, previousRun, saveRun } from "../storage/store.js";
 import { dim } from "../util/ansi.js";
-import { hookInstalled, nudgeStats } from "./install.js";
+import { hookInstalled } from "./install.js";
 function progress(done, total) {
     if (!process.stderr.isTTY || total < 12)
         return;
@@ -58,7 +58,6 @@ export async function runAudit(options) {
             audit,
             previous,
             history: runs,
-            nudges: nudgeStats(),
             installed: hookInstalled(),
             verbose: options.verbose,
         }));

package/dist/commands/control.js

@@ -1,13 +1,12 @@
 import { detailRows, helpOverlay, labelsFor, planRows } from "../report/views.js";
 import { PRESERVE_KINDS, renderSettings, selectableRows, settingsRows } from "../report/settings.js";
 import { keyActions, splitKeys } from "../scheduler/keys.js";
-import { buildPlan, cyclePriority, demote, promote, selectionIndex, equalize, cyclePolicy, cyclePreset, cycleTheme, moveSegment, nextShare, saveCustomAdvice, toggleColumn, togglePreserve, toggleSegment, setPriority, setShare, setPinned, resetPreferences, setState, visibleRows, } from "../scheduler/plan.js";
+import { buildPlan, cyclePriority, cycleStep, cycleWindow, demote, promote, selectionIndex, equalize, cyclePolicy, cyclePreset, cycleTheme, moveSegment, nextShare, saveCustomAdvice, toggleColumn, togglePreserve, toggleSegment, setPriority, setShare, setPinned, resetPreferences, setState, visibleRows, } from "../scheduler/plan.js";
 import { HUD_PRESETS, builtinThemes, loadConfig, loadTheme, paint, saveConfig, userThemes, windowBounds, } from "../runtime/kernel.mjs";
 import { hookInstalled, installPlan, runInstall } from "./install.js";
 import { colorEnabled, padEndVisible, visibleWidth } from "../util/ansi.js";
 import { ago } from "../util/fmt.js";
 const REFRESH_MS = 2500;
-const STEP = 0.05;
 const MAX_CUSTOM = 200;
 const ALT_ON = "\u001b[?1049h";
 const ALT_OFF = "\u001b[?1049l";
@@ -504,6 +503,10 @@ export async function runControl(options) {
                     else if (activate) {
                         if (current.kind === "reset")
                             resetPreferences();
+                        else if (current.kind === "window")
+                            cycleWindow();
+                        else if (current.kind === "step")
+                            cycleStep(1);
                         else if (current.kind === "column")
                             toggleColumn(current.id);
                         else if (current.kind === "segment")
@@ -519,7 +522,11 @@ export async function runControl(options) {
                     }
                     else if (action.kind === "share") {
                         const delta = action.delta > 0 ? 1 : -1;
-                        if (current.kind === "theme")
+                        if (current.kind === "window")
+                            cycleWindow();
+                        else if (current.kind === "step")
+                            cycleStep(delta);
+                        else if (current.kind === "theme")
                             cycleTheme(current.surface, delta, names);
                         else if (current.kind === "policy")
                             cyclePolicy(delta);
@@ -644,7 +651,7 @@ export async function runControl(options) {
                 draw();
                 return;
             }
-            for (const action of keyActions(String(chunk), mode === "settings" ? "prefs" : "plan", STEP)) {
+            for (const action of keyActions(String(chunk), mode === "settings" ? "prefs" : "plan", control.config.step ?? 0.05)) {
                 if (!apply(action))
                     return;
             }

package/dist/commands/install.js

@@ -156,7 +156,7 @@ export function runInstall(options) {
         ? `  keeps   your existing status line ${dim("(--force wraps it and appends the SMT segment)")}`
         : conflict
             ? `  wraps   your existing status line, then appends the SMT segment`
-            : `  sets    the status line, the only place Anthropic publishes your 5h and 7d usage`);
+            : `  sets    the status line, the only place your 5h and 7d usage`);
     out.push(`  backs up the current settings to ${path.join(HOME, "settings.backup.json")}`);
     if (options.rules)
         out.push(`  adds    a fenced token-discipline block to ${MEMORY}`);
@@ -352,18 +352,3 @@ function describeState() {
         return "";
     }
 }
-export function nudgeStats() {
-    try {
-        const parsed = JSON.parse(fs.readFileSync(path.join(HOME, "nudges.json"), "utf8"));
-        if (!Array.isArray(parsed.events) || parsed.events.length === 0)
-            return null;
-        return {
-            installedAt: parsed.installedAt ?? parsed.events[0]?.at ?? Date.now(),
-            fired: parsed.events.length,
-            usdAtStake: parsed.events.reduce((sum, event) => sum + (event.usd ?? 0), 0),
-        };
-    }
-    catch {
-        return null;
-    }
-}

package/dist/commands/privacy.js

@@ -9,7 +9,7 @@ export function runPrivacy() {
     out.push("");
     out.push(`  ${displayHome()}/claimants/  ${dim("one file per session: label, target share, priority, state")}`);
     out.push(`  ${displayHome()}/meter/      ${dim("token counts in five-minute buckets, and how far each transcript was read")}`);
-    out.push(`  ${displayHome()}/quota/      ${dim("the 5h and 7d percentages Anthropic publishes to the status line")}`);
+    out.push(`  ${displayHome()}/quota/      ${dim("the 5h and 7d percentages published to the status line")}`);
     out.push(`  ${displayHome()}/hooks/      ${dim("the three scripts install puts there")}`);
     out.push(`  ${displayHome()}/cache/      ${dim("per-session audit measurements, so repeat runs are fast")}`);
     out.push(dim("      · includes the first 120 characters of each prompt, so a finding or a row can"));

package/dist/report/render.js

@@ -70,7 +70,7 @@ function footer(audit, previous, history, verbose) {
     return parts.length > 0 ? [dim(parts.join(" · "))] : [];
 }
 export function renderAudit(input) {
-    const { audit, previous, history = [], nudges = null, installed = false, verbose = false } = input;
+    const { audit, previous, history = [], installed = false, verbose = false } = input;
     const columns = width();
     const out = [""];
     if (audit.totals.sessions === 0) {
@@ -125,12 +125,6 @@ export function renderAudit(input) {
         out.push(...wrap(dim(`${money(claudeUsd)} more is how Claude works, not how you work: ${claudes.map((f) => f.title.toLowerCase()).join(", ")}. Nothing for you to do by hand; install writes the rules that fix them.`), ""));
         out.push("");
     }
-    if (nudges && installed) {
-        out.push(`${green("Since you installed:")} ${nudges.fired} ${plural(nudges.fired, "warning")}, ${money(nudges.usdAtStake)} at stake ${dim(`(${ago(nudges.installedAt)})`)}`);
-    }
-    else if (!installed) {
-        out.push(`${green("Do this:")}  ${bold("npx savemytokens install")}   ${dim("→ warns you before the next one, and gives each session a target share")}`);
-    }
     out.push(...footer(audit, previous, history, verbose));
     if (verbose) {
         out.push("");

package/dist/report/settings.js

@@ -15,17 +15,17 @@ const SEGMENT_ABOUT = {
     target: "its allocation, as a percentage of the window",
     used: "how much of the window this session has spent",
     share: "its part of the tokens measured on disk",
-    pair: "used and allocation together, as 21%/50%",
+    pair: "how much of your allocation is gone, and what it is, as 84% of 17%",
     bar: "how far through its allocation it is",
     priority: "HIGH, NORMAL or LOW",
-    "5h": "the 5-hour window Anthropic publishes",
+    "5h": "the 5-hour window that is published",
     "7d": "the weekly window",
     spend: "a gateway spend limit, when you have one",
-    reset: "how long until the 5-hour window resets",
+    reset: "how long until the 5-hour window comes back",
     meter5h: "the 5-hour window drawn as a bar",
     spark: "the shape of the window so far",
     pace: "how far ahead or behind the clock you are",
-    empty: "when you run dry at this rate",
+    empty: "when you run dry, at this rate",
 };
 export function settingsRows(config) {
     const rows = [];
@@ -33,6 +33,10 @@ export function settingsRows(config) {
     for (const id of COLUMNS)
         rows.push({ kind: "column", id });
     rows.push({ kind: "blank" });
+    rows.push({ kind: "header", label: "THE WINDOW", hint: "← → changes it" });
+    rows.push({ kind: "window" });
+    rows.push({ kind: "step" });
+    rows.push({ kind: "blank" });
     rows.push({ kind: "header", label: "THEME", hint: "← → changes it" });
     rows.push({ kind: "theme", surface: "tui" });
     rows.push({ kind: "theme", surface: "hud" });
@@ -104,6 +108,7 @@ function themeNames() {
     return [...new Set([...builtinThemes(), ...userThemes()])];
 }
 const INDENT = 4;
+export const STEPS = [0.01, 0.05, 0.1];
 function clockAt(ms) {
     const at = new Date(ms);
     return `${String(at.getHours()).padStart(2, "0")}:${String(at.getMinutes()).padStart(2, "0")}`;
@@ -213,6 +218,20 @@ export function renderSettings(config, rows, cursor, editing, draft, preview, th
             }
             continue;
         }
+        if (row.kind === "window") {
+            const weekly = config.window === "seven_day";
+            const shown = `${weekly ? paint(theme, "dim", "5h", color) : paint(theme, "accent", "[5h]", color)}  ${weekly ? paint(theme, "accent", "[7d]", color) : paint(theme, "dim", "7d", color)}`;
+            const about = weekly ? "allocate against the weekly window" : "allocate against the 5-hour window";
+            out.push(`  ${mark} ${padEndVisible("window", 15)} ${shown}   ${paint(theme, "dim", clip(about, Math.max(0, width - 34)), color)}`);
+            continue;
+        }
+        if (row.kind === "step") {
+            const shown = STEPS.map((value) => Math.abs(value - config.step) < 1e-9
+                ? paint(theme, "accent", `[${Math.round(value * 100)}%]`, color)
+                : paint(theme, "dim", `${Math.round(value * 100)}%`, color)).join("  ");
+            out.push(`  ${mark} ${padEndVisible("arrow step", 15)} ${shown}   ${paint(theme, "dim", "how far ← → moves a target", color)}`);
+            continue;
+        }
         if (row.kind === "reset") {
             out.push(`  ${mark} ${paint(theme, "warn", "reset everything to defaults", color)}  ${paint(theme, "dim", "columns, themes, status line, policy. Your allocations stay.", color)}`);
             continue;

package/dist/report/views.js

@@ -4,15 +4,17 @@ import { clip, padEndVisible, padStartVisible, visibleWidth } from "../util/ansi
 import { ago, compactNumber } from "../util/fmt.js";
 import { emptyBar, heatStrip, miniSpark, percentLabel, smallBar } from "./graphs.js";
 function barCellsFor(columns) {
+    if (columns >= 150)
+        return 32;
     if (columns >= 130)
-        return 18;
+        return 26;
     if (columns >= 110)
-        return 15;
+        return 21;
     if (columns >= 95)
-        return 12;
+        return 17;
     if (columns >= 80)
-        return 9;
-    return 6;
+        return 12;
+    return 8;
 }
 const UNATTRIBUTED_FLOOR = 5;
 export function labelsFor(views) {
@@ -38,8 +40,10 @@ function capacityRow(control, context) {
         }
         return [`  ${paint(theme, "warn", clip(head, context.columns - 2), color)}`];
     }
+    const wide = Math.max(12, Math.min(24, Math.floor((context.columns - 58) / 2)));
     const levels = [
-        { bar: 12, reset: "clock", gap: 4 },
+        { bar: wide, reset: "clock", gap: 4 },
+        { bar: wide, reset: "long", gap: 4 },
         { bar: 12, reset: "long", gap: 4 },
         { bar: 10, reset: "short", gap: 3 },
         { bar: 6, reset: "short", gap: 2 },
@@ -133,11 +137,12 @@ function row(view, index, context, widths, columns) {
     const role = pressureRole(view.pressure.value);
     const cursor = context.interactive && context.selected === index ? paint(theme, "accent", theme.tui?.cursor ?? "❯", color) : " ";
     const pin = view.settings.pinned ? paint(theme, "accent", theme.tui?.pin ?? "★", color) : " ";
-    const open = view.bucket === "active";
+    const live = view.bucket === "active";
+    const open = view.consuming ?? live;
     const tone = (want) => (open ? want : "dim");
     const sessions = view.liveSessions > 1 ? paint(theme, "dim", `${view.liveSessions}`, color) : " ";
     const label = padEndVisible(paint(theme, tone("fg"), clip(view.label, widths.label - 1), color), widths.label - 1);
-    const held = view.allocation.target > 0 ? view.allocation.target : (view.settings.share ?? 0);
+    const held = open && view.allocation.target > 0 ? view.allocation.target : (view.settings.share ?? view.allocation.target);
     const asked = view.settings.share;
     const squeezed = asked != null && asked - held > 0.005;
     const allocationCell = padStartVisible(held > 0
@@ -161,8 +166,15 @@ function row(view, index, context, widths, columns) {
         cells.push(tokens);
     if (columns.includes("priority"))
         cells.push(priority);
+    const leaving = live && view.settings.kept === false;
     if (columns.includes("last prompt") && widths.prompt > 0) {
-        cells.push(paint(theme, "dim", clip(view.prompt || "-", widths.prompt), color));
+        const tag = leaving && widths.prompt >= 18 ? "leaving" : "";
+        const room = tag ? widths.prompt - tag.length - 2 : widths.prompt;
+        const prompt = padEndVisible(clip(view.prompt || "-", room), tag ? room : 0);
+        cells.push(`${paint(theme, "dim", prompt, color)}${tag ? `  ${paint(theme, "warn", tag, color)}` : ""}`);
+    }
+    else if (leaving) {
+        cells.push(paint(theme, "warn", "leaving", color));
     }
     return cells.join(" ");
 }
@@ -200,14 +212,19 @@ function idleRow(view, index, context, widths, now, columns) {
 function footerNote(control, context) {
     const { theme, color } = context;
     const set = workingSet(control.schedule, context.expanded);
-    const open = set.members.filter((view) => view.bucket === "active");
+    const open = set.members.filter((view) => view.consuming ?? view.bucket === "active");
     const sessions = open.reduce((sum, view) => sum + view.liveSessions, 0);
     const spare = Math.round(control.schedule.unusedPool * 100);
     const room = Math.max(10, context.columns - 2);
+    const leaving = set.members.filter((view) => view.bucket === "active" && view.settings.kept === false).length;
     const waiting = set.members.length - open.length;
     const long = `${open.length} of ${set.members.length} open, across ${sessions} ${sessions === 1 ? "session" : "sessions"}${waiting > 0 ? `, ${waiting} waiting` : ""}${spare > 0 ? `, ${spare}% unclaimed` : ""}.`;
     const short = `${open.length}/${set.members.length} open · ${sessions}s${spare > 0 ? ` · ${spare}% spare` : ""}`;
     const out = [`  ${paint(theme, "dim", long.length <= room ? long : short, color)}`];
+    if (leaving > 0) {
+        const note = leaving === 1 ? "One project leaves ACTIVE when its window closes." : `${leaving} projects leave ACTIVE when their windows close.`;
+        out.push(`  ${paint(theme, "dim", clip(note, room), color)}`);
+    }
     const drift = control.unattributed ?? 0;
     if (drift >= UNATTRIBUTED_FLOOR) {
         const head = `${Math.round(drift)}% of the window was spent outside these projects`;
@@ -385,6 +402,8 @@ export function helpOverlay(control, context) {
             out.push(`    ${gutter}  ${paint(theme, "dim", text, color)}`);
         }
     }
+    out.push(...helpSection("reading a row", context));
+    out.push(...helpProse("A star means you pinned it, and pinned rows keep the order you pinned them in. A number after it is how many Claude Code windows are open in that project, shown only when there is more than one. A dimmed row is holding its share while nothing runs there.", context));
     out.push(...helpSection("the two tables", context));
     out.push(...helpProse("ACTIVE is what shares your window. A project joins it on its own the moment you open Claude Code there, and stays after you close it, holding whatever target you gave it.", context));
     out.push("");
@@ -399,10 +418,10 @@ export function helpOverlay(control, context) {
     out.push(...helpProse("So allocation is your intent and priority is the tie-break. If pinned targets already add up to the whole window there is no spare, and priority does nothing.", context));
     out.push(...helpSection("the status line", context));
     out.push(...helpProse(control.installed
-        ? "Installed. It is the only place Anthropic publishes your 5h and 7d usage, 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 Anthropic publishes your 5h and 7d usage, and it is what proves a session is still open. Run: npx savemytokens install", context));
+        ? "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));
     out.push(...helpSection("the numbers", context));
-    out.push(...helpProse("5h and 7d are Anthropic's own. 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));
+    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;
     if (drift >= UNATTRIBUTED_FLOOR) {
         out.push("");

package/dist/runtime/hook.mjs

@@ -21,13 +21,6 @@ import {
 } from "./kernel.mjs";
 
 const ADAPTER = "claude-code";
-const NUDGE_FILE = path.join(HOME, "nudges.json");
-const NUDGE_THRESHOLD = 150000;
-const NUDGE_COOLDOWN_MS = 30 * 60 * 1000;
-const NUDGE_HORIZON_TURNS = 10;
-const NUDGE_TAIL_BYTES = 262144;
-const RATE_PER_TOKEN = 5 / 1000000;
-const CACHE_READ_WEIGHT = 0.1;
 const MAX_SUBAGENT_DEPTH = 4;
 const ANAPHORIC =
   /^\s*(ok|okay|now|also|and|then|next|again|yes|no|nope|yep|same|do the same|the other|these|those|them|it|that|this|continue|carry on|keep going|go on|more|another|fix (it|that|this)|try again|redo|revert|undo|hmm|wait|great|nice|thanks|perfect|good)\b/i;
@@ -102,68 +95,6 @@ function guidance(id, project, now) {
   });
 }
 
-function selfContained(prompt) {
-  const text = String(prompt || "").trim();
-  return text.length >= 40 && !ANAPHORIC.test(text);
-}
-
-function tailContext(file) {
-  let fd;
-  try {
-    fd = fs.openSync(file, "r");
-  } catch {
-    return 0;
-  }
-  try {
-    const size = fs.fstatSync(fd).size;
-    const start = Math.max(0, size - NUDGE_TAIL_BYTES);
-    const buffer = Buffer.alloc(size - start);
-    fs.readSync(fd, buffer, 0, buffer.length, start);
-    const lines = buffer.toString("utf8").split("\n");
-    for (let i = lines.length - 1; i >= 0; i--) {
-      const line = lines[i];
-      if (!line || !line.includes('"usage"')) continue;
-      let record;
-      try {
-        record = JSON.parse(line);
-      } catch {
-        continue;
-      }
-      const usage = record?.message?.usage;
-      if (!usage) continue;
-      const total =
-        (usage.input_tokens || 0) + (usage.cache_read_input_tokens || 0) + (usage.cache_creation_input_tokens || 0);
-      if (total > 0) return total;
-    }
-    return 0;
-  } catch {
-    return 0;
-  } finally {
-    try {
-      fs.closeSync(fd);
-    } catch {}
-  }
-}
-
-function deadCarryNudge(payload, now) {
-  if (!selfContained(payload.prompt)) return "";
-  const transcript = payload.transcript_path;
-  if (typeof transcript !== "string" || !fs.existsSync(transcript)) return "";
-  const context = tailContext(transcript);
-  if (context < NUDGE_THRESHOLD) return "";
-
-  const state = readJson(NUDGE_FILE, null);
-  const events = Array.isArray(state?.events) ? state.events : [];
-  const previous = events.filter((event) => event.session === payload.session_id).pop();
-  if (previous && now - previous.at < NUDGE_COOLDOWN_MS) return "";
-
-  const horizon = context * CACHE_READ_WEIGHT * RATE_PER_TOKEN * NUDGE_HORIZON_TURNS;
-  events.push({ at: now, session: payload.session_id, context, usd: horizon });
-  writeJson(NUDGE_FILE, { installedAt: state?.installedAt ?? now, events: events.slice(-500) });
-
-  return `[savemytokens] This reads as a new task and ${Math.round(context / 1000)}k tokens of earlier work are still in context, about $${horizon.toFixed(2)} per ${NUDGE_HORIZON_TURNS} turns from here. Open your reply with one short line saying so, and that /clear or a fresh session drops it. Then do what was asked.`;
-}
-
 function run() {
   const event = process.argv[2] ?? "";
   const payload = readInput();
@@ -212,8 +143,6 @@ function run() {
     });
     const advice = guidance(id, project, now);
     if (advice) lines.push(advice);
-    const nudge = deadCarryNudge(payload, now);
-    if (nudge) lines.push(nudge);
   }
 
   if (event === "stop") {

package/dist/runtime/kernel.mjs

@@ -25,6 +25,7 @@ const LOCKOUT_GAP_MS = 5 * 60 * 1000;
 const STALE_MS = 45 * 60 * 1000;
 const HEARTBEAT_MS = 60 * 1000;
 const RECENT_MS = 24 * 60 * 60 * 1000;
+const IDLE_MS = 10 * 60 * 1000;
 const DEFER_LIMIT = 12;
 const DEFER_RETENTION_MS = 14 * 24 * 60 * 60 * 1000;
 const CHUNK = 1 << 20;
@@ -61,6 +62,8 @@ function listJson(dir) {
   }
 }
 
+const DEFAULT_SEGMENTS = ["bar", "pair", "5h", "reset"];
+
 export const DEFAULT_CONFIG = {
   version: 1,
   createdAt: 0,
@@ -69,10 +72,12 @@ export const DEFAULT_CONFIG = {
   primerSeenAt: 0,
   theme: { tui: "default", hud: "default" },
   layout: { hud: "allocation" },
+  window: "five_hour",
+  step: 0.05,
   policy: "finish",
   policyFor: {},
   columns: ["allocation", "used", "priority", "last prompt"],
-  hud: { segments: ["project", "pair", "5h", "reset"] },
+  hud: { segments: [...DEFAULT_SEGMENTS] },
   preserveFor: {},
   customAdvice: {},
   wrappedStatusLine: null,
@@ -104,12 +109,13 @@ export function loadConfig() {
       ...(stored.theme?.hud && THEME_RENAMES[stored.theme.hud] ? { hud: THEME_RENAMES[stored.theme.hud] } : {}),
     },
     layout: { ...DEFAULT_CONFIG.layout, ...(stored.layout || {}) },
+    window: stored.window === "seven_day" ? "seven_day" : "five_hour",
+    step: [0.01, 0.05, 0.1].includes(stored.step) ? stored.step : DEFAULT_CONFIG.step,
     columns: migrateColumns(stored.columns),
     hud: {
-      segments:
-        Array.isArray(stored.hud?.segments) && stored.hud.segments.length > 0
-          ? stored.hud.segments
-          : presetSegments(stored.layout?.hud) ?? DEFAULT_CONFIG.hud.segments,
+      segments: Array.isArray(stored.hud?.segments)
+        ? stored.hud.segments
+        : presetSegments(stored.layout?.hud) ?? DEFAULT_CONFIG.hud.segments,
     },
     policyFor: { ...(stored.policyFor || {}) },
     preserveFor: { ...(stored.preserveFor || {}) },
@@ -315,7 +321,7 @@ export function projectKey(project) {
 }
 
 function blankProject(project) {
-  return { schema: 1, project, label: project ? projectLabel(project) : "unknown", share: null, priority: "normal", cap: null, pinned: false, parked: false, kept: null };
+  return { schema: 1, project, label: project ? projectLabel(project) : "unknown", share: null, priority: "normal", cap: null, pinned: false, pinnedAt: 0, parked: false, kept: null };
 }
 
 export function loadProject(adapter, project) {
@@ -810,17 +816,17 @@ export function schedule(adapter, now = Date.now(), key = "five_hour", quotaOver
     group.lastSeen = Math.max(group.lastSeen, claimant.lastSeen ?? 0);
   }
 
-  const entries = [...groups.values()].map((group) => {
-    const running = group.sessions.some((session) => session.bucket === "active");
-    return {
-      id: group.project,
-      share: group.settings.share,
-      priority: group.settings.priority,
-      state: running ? "active" : "done",
-      consumed: live ? (live.usedPercent / 100) * group.observed : 0,
-      cap: group.settings.cap,
-    };
-  });
+  const consumingNow = (group) =>
+    group.sessions.some((session) => session.bucket === "active") && now - (group.lastSeen ?? 0) <= IDLE_MS;
+
+  const entries = [...groups.values()].map((group) => ({
+    id: group.project,
+    share: group.settings.share,
+    priority: group.settings.priority,
+    state: consumingNow(group) ? "active" : "done",
+    consumed: live ? (live.usedPercent / 100) * group.observed : 0,
+    cap: group.settings.cap,
+  }));
 
   const eligible = entries.filter((entry) => entry.state === "active").length;
   const { targets, unusedPool } = allocate(entries);
@@ -863,6 +869,7 @@ export function schedule(adapter, now = Date.now(), key = "five_hour", quotaOver
       })
       .sort((a, b) => b.observed - a.observed);
 
+    const consuming = consumingNow(group);
     const bucket = sessions.some((session) => session.bucket === "active")
       ? "active"
       : group.settings.parked
@@ -881,6 +888,7 @@ export function schedule(adapter, now = Date.now(), key = "five_hour", quotaOver
       usage: { tokens: group.tokens, weighted: group.weighted, requests: group.requests },
       lastSeen: group.lastSeen,
       bucket,
+      consuming,
       attributedPercent: live ? live.usedPercent * group.observed : null,
       pressure:
         live || eligible > 1
@@ -1288,7 +1296,7 @@ export function formatCountdown(resetsAt, now = Date.now()) {
   if (minutes < 60) return `${minutes}m`;
   const hours = Math.floor(minutes / 60);
   const rest = minutes % 60;
-  if (hours < 24) return rest === 0 ? `${hours}h` : `${hours}h${String(rest).padStart(2, "0")}`;
+  if (hours < 24) return rest === 0 ? `${hours}h` : `${hours}h${String(rest).padStart(2, "0")}m`;
   const days = Math.floor(hours / 24);
   return `${days}d${hours % 24 > 0 ? `${hours % 24}h` : ""}`;
 }
@@ -1328,19 +1336,21 @@ export const HUD_SEGMENTS = [
 ];
 
 export const HUD_PRESETS = {
-  default: ["bar", "pair", "5h", "reset"],
+  default: [...DEFAULT_SEGMENTS],
   minimal: ["bar", "pair"],
   window: ["5h", "reset", "7d"],
   pacing: ["bar", "pace", "5h", "reset"],
   everything: ["project", "target", "used", "priority", "meter5h", "5h", "7d", "reset"],
+  off: [],
 };
 
 export const HUD_PRESET_ABOUT = {
   default: "a bar for your share, then the numbers",
   minimal: "the bar and your share, nothing else",
-  window: "only Anthropic's numbers, no per-project detail",
+  window: "only the published numbers, no per-project detail",
   pacing: "whether you are ahead of or behind the clock",
   everything: "every number there is",
+  off: "nothing is drawn, and the numbers still arrive",
 };
 
 const HUD_PRESET_ALIASES = {
@@ -1395,11 +1405,12 @@ const SEGMENTS = {
   },
   share: (view, theme, on) => `${paint(theme, "dim", "share", on)} ${percentText((view.observed ?? 0) * 100)}`,
   pair: (view, theme, on) => {
-    const value = typeof view.used === "number" ? view.used : (view.observed ?? 0) * 100;
-    return `${paint(theme, pressureRole(view.pressure ?? 0), percentText(value), on)}${paint(theme, "dim", `/${percentText((view.target ?? 0) * 100)}`, on)}`;
+    const target = (view.target ?? 0) * 100;
+    const spent = (view.pressure ?? 0) * 100;
+    return `${paint(theme, pressureRole(view.pressure ?? 0), percentText(spent), on)}${paint(theme, "dim", ` of ${percentText(target)}`, on)}`;
   },
   bar: (view, theme, on) =>
-    hudMeter(theme, view.pressure ?? 0, 8, pressureRole(view.pressure ?? 0), on, theme.glyphs?.hudFull ?? "\u28ff", theme.glyphs?.hudEmpty ?? "\u28c0"),
+    hudMeter(theme, view.pressure ?? 0, 12, pressureRole(view.pressure ?? 0), on, theme.glyphs?.hudFull ?? "\u28ff", theme.glyphs?.hudEmpty ?? "\u28c0"),
   priority: (view, theme, on) => paint(theme, "dim", String(view.priority ?? "normal").toUpperCase(), on),
   "5h": (view, theme, on) => {
     const window = windowOf(view, "five_hour");
@@ -1417,11 +1428,11 @@ const SEGMENTS = {
     const window = windowOf(view, "five_hour");
     if (!window || typeof window.resetsAt !== "number") return "";
     const left = formatCountdown(window.resetsAt, view.now);
-    return left ? paint(theme, "dim", `in ${left}`, on) : "";
+    return left ? paint(theme, "dim", `resets in ${left}`, on) : "";
   },
   meter5h: (view, theme, on) => {
     const window = windowOf(view, "five_hour");
-    return window ? hudMeter(theme, window.usedPercent / 100, 8, pressureRole(window.usedPercent / 100), on) : "";
+    return window ? hudMeter(theme, window.usedPercent / 100, 12, pressureRole(window.usedPercent / 100), on) : "";
   },
   spark: (view, theme, on) => {
     const points = Array.isArray(view.history) ? view.history.slice(-12) : [];
@@ -1436,7 +1447,9 @@ const SEGMENTS = {
     if (!window || typeof view.from !== "number" || typeof view.to !== "number") return "";
     const elapsed = Math.max(0, Math.min(1, (view.now - view.from) / Math.max(1, view.to - view.from))) * 100;
     const ahead = window.usedPercent - elapsed;
-    return paint(theme, ahead > 5 ? "warn" : "ok", `${ahead >= 0 ? "+" : ""}${Math.round(ahead)} vs pace`, on);
+    const points = Math.abs(Math.round(ahead));
+    if (points < 1) return paint(theme, "ok", "on pace", on);
+    return paint(theme, ahead > 5 ? "warn" : "ok", `${points}% ${ahead > 0 ? "ahead of" : "behind"} the clock`, on);
   },
   empty: (view, theme, on) => {
     const window = windowOf(view, "five_hour");
@@ -1444,7 +1457,7 @@ const SEGMENTS = {
     const at = view.now + ((100 - window.usedPercent) / view.rate) * 3600000;
     const resetsAt = typeof window.resetsAt === "number" ? window.resetsAt * 1000 : null;
     if (resetsAt !== null && at >= resetsAt) return paint(theme, "ok", "lasts the window", on);
-    return paint(theme, "danger", `empty ${formatReset(Math.floor(at / 1000), view.now)}`, on);
+    return paint(theme, "danger", `runs dry ${formatReset(Math.floor(at / 1000), view.now)}`, on);
   },
 };
 

package/dist/runtime/statusline.mjs

@@ -234,7 +234,8 @@ function run() {
   );
 
   const prefix = wrappedOutput(config, raw);
-  process.stdout.write(prefix ? `${prefix}  ${line}\n` : `${line}\n`);
+  if (!prefix && !line) return;
+  process.stdout.write(prefix ? (line ? `${prefix}  ${line}\n` : `${prefix}\n`) : `${line}\n`);
 }
 
 try {

package/dist/scheduler/plan.js

@@ -41,14 +41,15 @@ function unattributedPercent(plan) {
     }
     return drift > 0 ? drift : null;
 }
-export function buildPlan(now = Date.now(), withSweep = true, window = "five_hour", adapter = "claude-code") {
+export function buildPlan(now = Date.now(), withSweep = true, window, adapter = "claude-code") {
     const provider = providerFor(adapter);
+    const chosen = window ?? (loadConfig().window === "seven_day" ? "seven_day" : "five_hour");
     if (withSweep) {
-        const bounds = windowBounds(loadQuota(provider.id), window, now);
-        const span = WINDOW_MS[window] ?? FIVE_HOUR_MS;
+        const bounds = windowBounds(loadQuota(provider.id), chosen, now);
+        const span = WINDOW_MS[chosen] ?? FIVE_HOUR_MS;
         provider.sweep(Math.min(bounds.from, now - span), now);
     }
-    const plan = schedule(provider.id, now, window, null, provider.dataDir ?? null);
+    const plan = schedule(provider.id, now, chosen, null, provider.dataDir ?? null);
     const others = detectedProviders()
         .filter((other) => other.id !== provider.id)
         .map((other) => ({ id: other.id, label: other.label, resources: other.resources(now) }));
@@ -78,8 +79,15 @@ function byInterest(a, b) {
     const live = Number(b.bucket === "active") - Number(a.bucket === "active");
     if (live !== 0)
         return live;
-    return (Number(b.settings.pinned) - Number(a.settings.pinned) ||
-        (b.allocation.target || b.settings.share || 0) - (a.allocation.target || a.settings.share || 0) ||
+    const pinned = Number(b.settings.pinned) - Number(a.settings.pinned);
+    if (pinned !== 0)
+        return pinned;
+    if (a.settings.pinned && b.settings.pinned) {
+        const order = (a.settings.pinnedAt || 0) - (b.settings.pinnedAt || 0);
+        if (order !== 0)
+            return order;
+    }
+    return ((b.allocation.target || b.settings.share || 0) - (a.allocation.target || a.settings.share || 0) ||
         b.lastSeen - a.lastSeen);
 }
 export function workingSet(plan, full = false) {
@@ -181,6 +189,19 @@ export function resetPreferences() {
         wrappedStatusLine: config.wrappedStatusLine,
     });
 }
+export function cycleWindow() {
+    const config = loadConfig();
+    config.window = config.window === "seven_day" ? "five_hour" : "seven_day";
+    saveConfig(config);
+}
+export function cycleStep(delta) {
+    const config = loadConfig();
+    const steps = [0.01, 0.05, 0.1];
+    const at = steps.findIndex((value) => Math.abs(value - config.step) < 1e-9);
+    const next = steps[(((at === -1 ? 1 : at) + (delta > 0 ? 1 : steps.length - 1)) % steps.length)];
+    config.step = next ?? 0.05;
+    saveConfig(config);
+}
 export function toggleColumn(id) {
     const config = loadConfig();
     const columns = withToggled(config.columns, id);
@@ -248,7 +269,7 @@ export function saveCustomAdvice(project, text) {
     saveConfig(config);
 }
 export function setPinned(project, pinned, adapter = "claude-code") {
-    upsertProject(adapter, project, { pinned });
+    upsertProject(adapter, project, { pinned, pinnedAt: pinned ? Date.now() : 0 });
 }
 export function setParked(project, parked, adapter = "claude-code") {
     upsertProject(adapter, project, { parked });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "savemytokens",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",