claude-usage-limits 1.15.0 → 1.16.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "usage-limits",
   "displayName": "Usage Limits",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Puts your remaining Claude Code usage limit into Claude's context before every prompt, so it opens with what fits in the budget instead of starting work that gets cut off. Reports headroom as turns rather than percentages, prices a job before you start it, and detects your plan tier.",
   "author": {
     "name": "Ridelink",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "usage-limits",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Reports how much of your Codex usage limit is left as turns of work rather than a percentage, prices a job before you start it, and counts the other agents sharing the same budget.",
   "author": {
     "name": "Ridelink",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-usage-limits",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Puts your remaining Claude Code usage limit into Claude's context before every prompt, so it opens with what fits in the budget instead of starting work that gets cut off. Reports headroom as turns rather than percentages, prices a job before you start it, and detects your plan tier.",
   "keywords": [
     "claude",

package/skills/usage-limits/scripts/brief.js

@@ -717,7 +717,15 @@ function briefText(parts) {
     // that is a real session: the Fable weekly hit 89 per cent, the line said
     // the budget was nearly gone, and the work ended with the five-hour window
     // at 46 and every other model untouched.
-    escapeText && (parts.pressure === 'tight' || parts.pressure === 'gone')
+    // Only a MODEL switch survives to 'gone'. It retires a scoped window
+    // outright, so the budget really is still there. Effort does not: a
+    // cheaper turn against an exhausted window is still a turn you cannot
+    // take, and telling a session at 100 per cent that it is "not out of
+    // budget" because medium is cheaper than high would be this plugin
+    // producing the exact failure it exists to prevent, in reverse - refusing
+    // to stop at the one moment stopping is right.
+    escapeText &&
+    (parts.pressure === 'tight' || (parts.pressure === 'gone' && escape && escape.kind === 'model'))
       ? 'This window is nearly gone, but you are not out of budget and you must ' +
         'not stop as though you were. ' + escapeText + ' Do that, say in one ' +
         'line that you switched and why, and carry on with the whole request at ' +

package/skills/usage-limits/scripts/feed.js

@@ -238,10 +238,25 @@ function line(built, options) {
     Number.isFinite(built.othersWorking) && built.othersWorking > 0
       ? bars.paint('+' + built.othersWorking + ' working', bars.THEME.claude, mode)
       : '';
+  // Agents spend the same window and were the one thing on it with no voice.
+  // A fan-out can empty half a five-hour window in five minutes while the line
+  // shows one session working, so the count goes on the line whenever any are
+  // live - and it is dropped first when the terminal is too narrow, because a
+  // percentage the user cannot see is worse than a count they cannot see.
+  const agents =
+    built.agents && built.agents.running > 0
+      ? bars.paint(
+          '+' + built.agents.running + ' agent' + (built.agents.running === 1 ? '' : 's') +
+            (built.agents.runs > 1 ? ' (' + built.agents.runs + ' runs)' : ''),
+          bars.THEME.claude,
+          mode
+        )
+      : '';
   let text = '';
   for (const attempt of attempts) {
     const parts = built.rows.map((row) => segment(row, attempt.width, attempt.shorter));
     if (others) parts.push(others);
+    if (agents && !attempt.shorter) parts.push(agents);
     if (attempt.head) parts.unshift(head);
     text = parts.join(attempt.gap || '  ');
     if (bars.visibleWidth(text) <= columns) return text;
@@ -445,6 +460,7 @@ async function main(argv) {
       .filter((row) => row.state === 'working' && row.sessionId !== mine).length;
     const built = view.build({
       now,
+      agents: usage.liveAgents(now),
       utilization: collected.utilization,
       fetchedAtMs: collected.snapshotFetchedAt,
       source: collected.snapshotSource,

package/skills/usage-limits/scripts/usage.js

@@ -534,6 +534,75 @@ function subagentTranscripts(dir, since, depth) {
   return files;
 }
 
+// The agents working right now, and what they have cost.
+//
+// Their spend has always been counted - the scan walks subagents/ and
+// workflows/ and every token lands in the window totals - but nothing ever
+// SHOWED them. So a display could say one session was working while eighteen
+// agents underneath it spent two million tokens, and the only sign was the
+// percentage moving for no visible reason. One workflow in this plugin's own
+// development did exactly that twice in an afternoon.
+//
+// Cheap on purpose: it stats files under the session's own subagent
+// directories and never parses one. The panel redraws every second.
+const AGENT_LIVE_MS = 90 * 1000;
+
+// Measured at about 95 ms on a machine with a few hundred agent transcripts.
+// The panel redraws every second, so without this it would spend a tenth of
+// every frame stat-ing files that cannot have changed much.
+let agentMemo = null;
+const AGENT_MEMO_MS = 2000;
+
+function liveAgents(now, windowMs) {
+  const at = Number.isFinite(now) ? now : Date.now();
+  const within = Number.isFinite(windowMs) ? windowMs : AGENT_LIVE_MS;
+  if (agentMemo && agentMemo.within === within && at - agentMemo.at < AGENT_MEMO_MS) return agentMemo.value;
+  const root = path.join(configDir(), 'projects');
+  let projects = [];
+  try {
+    projects = fs.readdirSync(root, { withFileTypes: true });
+  } catch (err) {
+    return { running: 0, runs: 0, newestAt: null };
+  }
+  let running = 0;
+  const runs = new Set();
+  // projects/<project>/<sessionId>/subagents/[workflows/<run>/]agent-*.jsonl -
+  // the session id is a level the first version of this walked straight past,
+  // which is why it counted nothing on a machine with a hundred and fifty
+  // agent transcripts an hour old.
+  for (const project of projects) {
+    if (!project.isDirectory()) continue;
+    let sessions = [];
+    try {
+      sessions = fs.readdirSync(path.join(root, project.name), { withFileTypes: true });
+    } catch (err) {
+      continue;
+    }
+    for (const session of sessions) {
+      if (!session.isDirectory()) continue;
+      const dir = path.join(root, project.name, session.name, 'subagents');
+      for (const file of subagentTranscripts(dir, at - within, 3)) {
+        let stat;
+        try {
+          stat = fs.statSync(file);
+        } catch (err) {
+          continue;
+        }
+        if (at - stat.mtimeMs > within) continue;
+        running += 1;
+        // .../workflows/<run>/agent-x.jsonl - the run is what a person
+        // recognises, so it is counted as well as the agents. An agent that is
+        // not in a workflow sits directly in subagents/ and is its own run.
+        const parent = path.basename(path.dirname(file));
+        runs.add(parent === 'subagents' ? 'agent:' + path.basename(file) : parent);
+      }
+    }
+  }
+  const value = { running, runs: runs.size, newestAt: running ? at : null };
+  agentMemo = { at, within, value };
+  return value;
+}
+
 function claudeTranscriptFiles(since) {
   const root = path.join(configDir(), 'projects');
   let dirs = [];
@@ -3714,6 +3783,8 @@ module.exports = {
   preferLive,
   accountUuid,
   subagentTranscripts,
+  liveAgents,
+  AGENT_LIVE_MS,
   claudeTranscriptFiles,
   readClaudeEvents,
   SCAN_VERSION,

package/skills/usage-limits/scripts/view.js

@@ -352,6 +352,9 @@ function build(input) {
     rows,
     fable,
     hidden,
+    // The agents underneath this session. They spend the same window and had
+    // no voice on any display until now.
+    agents: opts.agents && Number.isFinite(opts.agents.running) ? opts.agents : { running: 0, runs: 0 },
     model,
     modelLabel: opts.modelName || bars.prettyModel(model),
     effort,