@inbrace-tech/tokenline 1.3.0 → 1.5.0

package/README.md

@@ -40,12 +40,16 @@ npx @inbrace-tech/tokenline@latest update --global   # or: update (project), upd
 
 `update` finds the script your `statusLine` points at and replaces it. It never edits `settings.json`, and there's nothing to restart.
 
-You don't have to remember to check. About once a day, an installed copy looks up the latest published version in the background. When a newer one exists, it adds one gray line to the statusline:
+Because of that, a feature that needs a new settings key isn't switched on by `update` alone. Installed before [subagent rows](#subagent-rows-claude-code)? `update` says so and prints the one command that adds them, for the same scope and `--dir`, e.g. `npx -y @inbrace-tech/tokenline@latest init --global`. Re-running `init` is safe: it confirms your existing `statusLine` and only adds `subagentStatusLine`.
+
+You don't have to remember to check. An installed copy looks up the latest published version in the background: when you open a new session (if the last check is over an hour old), and at least every 6 hours in a long one. When a newer version exists, it adds one gray line to the statusline:
 
 ```
-↑ tokenline 1.3.0 available · npx @inbrace-tech/tokenline@latest update --global
+↑ tokenline 1.4.0 available · update: ! npx -y @inbrace-tech/tokenline@latest update --global
 ```
 
+In Claude Code, type that line (with the leading `!`) at the prompt to run it without leaving the session. The next refresh shows the new version.
+
 The check is a single `GET` to `registry.npmjs.org` for the version number, made only if `curl` is installed. It runs detached, so rendering never waits on the network. Nothing about your session is sent, and nothing downloaded is executed: only a plain `x.y.z` version is accepted and shown. To turn it off, set `TOKENLINE_NO_UPDATE_CHECK=1` (`DO_NOT_TRACK=1` works too).
 
 ---
@@ -54,12 +58,28 @@ The check is a single `GET` to `registry.npmjs.org` for the version number, made
 
 ![Tokenline Preview](https://raw.githubusercontent.com/inbrace-tech/tokenline/main/assets/tokenline.png)
 
-- **Line 1** — model · context used (tokens + %) · cache TTL with a live HOT→COLD countdown.
+- **Line 1** — model · reasoning effort (the session's current level, coloured from green at `low`/`medium` to red at `max`, and updated when you change it with `/effort`) · context used (tokens + %) · cache TTL with a live HOT→COLD countdown.
 - **Line 2** — per-turn token economics: `read / write / new / output`, the equivalent billed tokens (`eq`), and the **`saving %`** you get from prompt caching.
 - **Line 3** — 5h and 7d rate-limit bars with reset ETA and a **pace marker** (`!!` = you're burning the window faster than it refills).
 
 > Lines 2 and 3 appear only when there's something to show (a turn happened, limits exist), so the bar stays quiet when idle.
 
+### Subagent rows (Claude Code)
+
+The same script also renders Claude Code's agent panel, one row per subagent, each with **its own** cache countdown:
+
+```
+code-reviewer    ●  3m32s  ctx: 45.2k (22%)   [5m] cache: 3:28 HOT  waiting: Bash  Review the auth diff
+general-purpose  ●  15m22s ctx: 170.0k (85%)  [5m] cache: COLD      last: Read     Run the e2e suite
+Explore          ✓  1m22s  ctx: 8.0k          [5m] cache: 4:18 HOT                 Find callers
+```
+
+Subagent requests write the **5-minute** cache. That's fine while a subagent keeps working, since every turn refreshes it. But a subagent that waits (on a long test run, a slow build, a question to you) goes cold without a sound, and its next turn pays a full cache write instead of a cheap read. The row shows it: the countdown runs while `waiting: Bash` names what it's waiting on (`waiting: Bash (bg)` for a subagent idling on its own background job, which Claude Code reports as finished until the job wakes it), and an active subagent that goes cold blinks `COLD`. Finished subagents keep their countdown (they can be resumed) but never blink.
+
+The countdown tracks the subagent's **own** last request. The part of the prompt it shares with siblings on the same model (system prompt, tools) can stay warm because of them, so after a `COLD` the next turn still reads that shared part from cache and re-writes the rest: its own conversation. Claude Code refreshes the agent panel every ~5 seconds, so the countdown moves in 5-second steps.
+
+Columns: agent type · status (`●` running, `✓` done, `✗` failed, `■` stopped) · model · effort · elapsed · context · cache · last tool · description. A field Claude Code hasn't sent yet (an unresolved model, an inherited effort, no transcript before the first response) stays blank or shows `cache: --`, never a guess. On a narrow panel the description is cut first, then effort, model, context, elapsed and activity are dropped whole, in that order; type, status and cache always stay. `init` wires this in as `subagentStatusLine`; pass `--no-subagents` to skip it.
+
 ## About
 
 `tokenline` turns the one-line status bar of your AI coding CLI into a live cockpit:
@@ -85,7 +105,7 @@ LLMs are stateless — by default, they must reread your entire codebase context
 
 **Prompt Caching** solves this by saving that processed state in the provider's memory:
 - **Cache Write (Cold):** The model reads everything and stores the state. This costs slightly more than base tokens.
-- **Cache Hit (Warm):** If your prompt prefix matches the cached state exactly, the model skips the reading phase. This is **~90% cheaper** (**97.5%** on Claude Fable 5.1 / Mythos 5.1, which bill cache hits at 0.025x base input, and **95%** on Claude Opus 5.5 at 0.05x) and starts responding almost instantly. `tokenline` picks the right multiplier from the active model.
+- **Cache Hit (Warm):** If your prompt prefix matches the cached state exactly, the model skips the reading phase. This is **~90% cheaper** (**97.5%** on Claude Fable 5.1 / Mythos 5.1, which bill cache hits at 0.025x base input, and **95%** on Claude Opus 5.5 and Claude Sonnet 5.5 at 0.05x; Claude Haiku 5.5 keeps the standard 0.1x; Gemini 4 Argon bills cache hits at 0.05x too, against 0.25x on other Gemini models) and starts responding almost instantly. `tokenline` picks the right multiplier from the active model.
 - **TTL (Time-To-Live):** The cache operates as a **sliding window**. Every cache hit resets the countdown to its full duration for free. The secret to minimizing rate-limit drain is adjusting your workflow pace to keep the cache continuously **HOT**.
 
 ### 💡 Pro-tip: Forcing a 5m TTL to save rate limits
@@ -142,9 +162,15 @@ Add the printed block to your project's `.claude/settings.json` (or `~/.claude/s
   "type": "command",
   "command": "bash /absolute/path/to/tokenline/tokenline.sh",
   "refreshInterval": 1
+},
+"subagentStatusLine": {
+  "type": "command",
+  "command": "bash /absolute/path/to/tokenline/tokenline.sh"
 }
 ```
 
+(`subagentStatusLine` is Claude Code only — leave it out for the Antigravity CLI.)
+
 Then restart Claude Code.
 
 ### What the installer does
@@ -152,10 +178,10 @@ Then restart Claude Code.
 `npx @inbrace-tech/tokenline init` is deliberately transparent about touching your config:
 
 - **Writes** `tokenline.sh` to `./.claude/` (or `~/.claude/` with `--global`, or `~/.gemini/antigravity-cli/` with `--antigravity`).
-- **Merges** only the `statusLine` key into `settings.json` — every other setting is preserved.
+- **Merges** only the `statusLine` key (and, for Claude Code, `subagentStatusLine`) into `settings.json` — every other setting is preserved.
 - **Backs up** `settings.json` to `settings.json.bak` before writing.
 - **Never clobbers** invalid JSON: if it can't parse your `settings.json`, it stops and prints the block to paste manually.
-- Is **idempotent**, and won't replace a different existing `statusLine` unless you pass `--force`.
+- Is **idempotent**, and won't replace a different existing `statusLine` unless you pass `--force`. A different existing `subagentStatusLine` is kept (with a note) rather than failing the install; `--force` replaces it too.
 - **Stamps** the copy with the installed version and the command that updates it (two lines near the top of the script). The repo's own `tokenline.sh` stays unstamped.
 
 Other commands: `update` (replace the installed script, see [Updating](#updating)), `doctor` (check dependencies and config, change nothing) and `uninstall` (remove the block; `--purge` also deletes the script).
@@ -166,7 +192,7 @@ Other commands: `update` (replace the installed script, see [Updating](#updating
 
 ## How it works
 
-On every refresh the host CLI pipes a JSON snapshot of the session to the script over stdin. `tokenline` parses it in a single `jq` pass (to keep the per-second refresh cheap), reads the last turn's timestamp from the transcript to drive the cache countdown, and renders up to three lines. Per-turn timestamps are cached in a per-user `0700` directory under `$XDG_RUNTIME_DIR` (tmpfs, cleared on logout).
+On every refresh the host CLI pipes a JSON snapshot of the session to the script over stdin. `tokenline` parses it in a single `jq` pass (to keep the per-second refresh cheap), reads the last turn's timestamp from the transcript to drive the cache countdown, and renders up to three lines. Per-turn timestamps (and, for subagent rows, each subagent's last-turn time, TTL and last tool name) are cached in a per-user `0700` directory under `$XDG_RUNTIME_DIR` (tmpfs, cleared on logout); the payload itself never touches disk.
 
 ## Troubleshooting
 

package/dist/cli.js

@@ -1,54 +1,61 @@
 #!/usr/bin/env node
-"use strict";var Q=require("fs"),X=require("path");var _=require("os"),u=require("path"),D=(0,u.join)(__dirname,"..","tokenline.sh"),J=t=>t.targetCli==="antigravity"?(0,u.join)((0,_.homedir)(),".gemini","antigravity-cli"):t.global?(0,u.join)((0,_.homedir)(),".claude"):(0,u.resolve)(".claude");var w=t=>t.dir?(0,u.resolve)(t.dir,"tokenline.sh"):(0,u.join)(J(t),"tokenline.sh"),p=t=>(0,u.join)(J(t),"settings.json"),q=t=>t.targetCli==="antigravity"?"antigravity (global)":t.global?"claude (global)":"claude (project)",A=t=>t.includes(" ")?`bash "${t}"`:`bash ${t}`;var b=require("fs");function m(t){if(!(0,b.existsSync)(t))return{exists:!1,data:{}};let e=(0,b.readFileSync)(t,"utf8");if(e.trim()==="")return{exists:!0,data:{},raw:e};try{return{exists:!0,data:JSON.parse(e),raw:e}}catch{return{exists:!0,data:null,raw:e}}}function C(t){let e=`${t}.bak`;return(0,b.copyFileSync)(t,e),e}var L=t=>typeof t=="string"&&/tokenline\.sh/.test(t);var j=require("child_process"),F=require("os");var tt=!!process.stdout.isTTY&&!process.env.NO_COLOR,x=(t,e)=>tt?`\x1B[${t}m${e}\x1B[0m`:e,a=t=>x("1",t),et=t=>x("2",t),h=t=>x("32",t),nt=t=>x("31",t),rt=t=>x("33",t),k=t=>console.log(`${h("\u2713")} ${t}`),l=t=>console.log(`${rt("!")} ${t}`),g=t=>console.error(`${nt("\u2717")} ${t}`),i=t=>console.log(`${et("\u2192")} ${t}`);function T(){let t=(0,F.platform)();return t==="linux"||t==="darwin"?(k(`platform: ${t} (supported)`),!0):(l(`platform: ${t} \u2014 supported on Linux/WSL2 and macOS; the bash statusline likely won't render yet (see roadmap). Use --force to install anyway.`),!1)}function O(){let t=(0,j.spawnSync)("jq",["--version"],{encoding:"utf8"});return t.status===0?(k(String(t.stdout).trim()),!0):(l("jq not found \u2014 required at runtime. Install it (apt install jq / brew install jq)."),!1)}function N(){let t=(0,j.spawnSync)("bash",["--version"],{encoding:"utf8"});if(t.status===0){let e=String(t.stdout).match(/version (\d+)\.(\d+)/);return e&&Number(e[1])>=4?(k(`bash ${e[1]}.${e[2]}`),!0):(l(`bash ${e?`${e[1]}.${e[2]}`:"?"} found \u2014 the script needs bash 4+.`),!1)}return l("bash not found \u2014 the statusline runs as a bash script."),!1}function B(){console.log(a(`
+"use strict";var lt=require("fs"),ct=require("path");var D=require("os"),d=require("path"),B=(0,d.join)(__dirname,"..","tokenline.sh"),F=t=>t.targetCli==="antigravity"?(0,d.join)((0,D.homedir)(),".gemini","antigravity-cli"):t.global?(0,d.join)((0,D.homedir)(),".claude"):(0,d.resolve)(".claude");var w=t=>t.dir?(0,d.resolve)(t.dir,"tokenline.sh"):(0,d.join)(F(t),"tokenline.sh"),m=t=>(0,d.join)(F(t),"settings.json"),M=t=>t.targetCli==="antigravity"?"antigravity (global)":t.global?"claude (global)":"claude (project)",K=t=>t.includes(" ")?`bash "${t}"`:`bash ${t}`;var x=require("fs");function p(t){if(!(0,x.existsSync)(t))return{exists:!1,data:{}};let e=(0,x.readFileSync)(t,"utf8");if(e.trim()==="")return{exists:!0,data:{},raw:e};try{return{exists:!0,data:JSON.parse(e),raw:e}}catch{return{exists:!0,data:null,raw:e}}}function O(t){let e=`${t}.bak`;return(0,x.copyFileSync)(t,e),e}var h=t=>typeof t=="string"&&/tokenline\.sh/.test(t);function V(t,e,n){return t===void 0?"add":t.command===e?"confirm":typeof t.command=="string"&&h(t.command)||n?"replace":"keep"}function W(t){if(typeof t=="object"&&t!==null&&"command"in t){let{command:e}=t;if(typeof e=="string")return e}return"no command"}function J(t){let e=[];return h(t.statusLine?.command)&&(delete t.statusLine,e.push("statusLine")),h(t.subagentStatusLine?.command)&&(delete t.subagentStatusLine,e.push("subagentStatusLine")),e}var A=require("child_process"),H=require("os");var dt=!!process.stdout.isTTY&&!process.env.NO_COLOR,L=(t,e)=>dt?`\x1B[${t}m${e}\x1B[0m`:e,u=t=>L("1",t),gt=t=>L("2",t),b=t=>L("32",t),mt=t=>L("31",t),pt=t=>L("33",t),y=t=>console.log(`${b("\u2713")} ${t}`),a=t=>console.log(`${pt("!")} ${t}`),g=t=>console.error(`${mt("\u2717")} ${t}`),s=t=>console.log(`${gt("\u2192")} ${t}`);function N(){let t=(0,H.platform)();return t==="linux"||t==="darwin"?(y(`platform: ${t} (supported)`),!0):(a(`platform: ${t} \u2014 supported on Linux/WSL2 and macOS; the bash statusline likely won't render yet (see roadmap). Use --force to install anyway.`),!1)}function R(){let t=(0,A.spawnSync)("jq",["--version"],{encoding:"utf8"});return t.status===0?(y(String(t.stdout).trim()),!0):(a("jq not found \u2014 required at runtime. Install it (apt install jq / brew install jq)."),!1)}function E(){let t=(0,A.spawnSync)("bash",["--version"],{encoding:"utf8"});if(t.status===0){let e=String(t.stdout).match(/version (\d+)\.(\d+)/);return e&&Number(e[1])>=4?(y(`bash ${e[1]}.${e[2]}`),!0):(a(`bash ${e?`${e[1]}.${e[2]}`:"?"} found \u2014 the script needs bash 4+.`),!1)}return a("bash not found \u2014 the statusline runs as a bash script."),!1}function G(){console.log(u(`
 tokenline \u2014 environment check
-`)),T(),N(),O();let t=[{global:!1,dir:null,targetCli:"claude"},{global:!0,dir:null,targetCli:"claude"},{global:!0,dir:null,targetCli:"antigravity"}];for(let e of t){let n=q(e),o=p(e),r=m(o);r.exists&&r.data&&L(r.data.statusLine?.command)?k(`${n} settings: tokenline configured (${o})`):r.exists&&r.data===null?l(`${n} settings: invalid JSON (${o})`):i(`${n} settings: not configured (${o})`)}console.log()}var I=require("fs"),V=require("path");var ot='TOKENLINE_VERSION=""',it='TOKENLINE_UPDATE_CMD=""',st=/^\d+\.\d+\.\d+$/,E=t=>{let e="npx @inbrace-tech/tokenline@latest update";return t.targetCli==="antigravity"?`${e} --antigravity`:t.global?`${e} --global`:e};function K(t,e,n){if(!st.test(e))throw new Error(`Invalid version: ${e}`);if(n.includes("'"))throw new Error("Update command must not contain a single quote");let o=t.split(`
-`),r=(d,c)=>{let f=o.flatMap((v,S)=>v===d?[S]:[]);if(f.length!==1)throw new Error(`Expected exactly one "${d}" line in tokenline.sh`);o[f[0]]=c};return r(ot,`TOKENLINE_VERSION="${e}"`),r(it,`TOKENLINE_UPDATE_CMD='${n}'`),o.join(`
-`)}function M(t){if(typeof t!="string")return null;let e=/^bash (?:"([^"$`\\]+)"|([^\s"'$`\\]+))$/.exec(t),n=e?e[1]??e[2]:void 0;return n!==void 0&&n.endsWith("/tokenline.sh")?n:null}var s=require("fs"),y=require("path");function R(t,e,n){let o=K((0,s.readFileSync)(D,"utf8"),e,n);at(t,o)}function at(t,e){let n=(0,s.existsSync)(t)?(0,s.realpathSync)(t):t;(0,s.mkdirSync)((0,y.dirname)(n),{recursive:!0});let o=(0,y.join)((0,y.dirname)(n),`.${(0,y.basename)(n)}.${process.pid}.tmp`);(0,s.writeFileSync)(o,e,{flag:"wx",mode:493});try{(0,s.chmodSync)(o,493),(0,s.renameSync)(o,n)}catch(r){throw(0,s.rmSync)(o,{force:!0}),r}}function W(t,e){if(console.log(a(`
+`)),N(),E(),R();let t=[{global:!1,dir:null,targetCli:"claude"},{global:!0,dir:null,targetCli:"claude"},{global:!0,dir:null,targetCli:"antigravity"}];for(let e of t){let n=M(e),r=m(e),o=p(r);if(o.exists&&o.data&&h(o.data.statusLine?.command)?y(`${n} settings: tokenline configured (${r})`):o.exists&&o.data===null?a(`${n} settings: invalid JSON (${r})`):s(`${n} settings: not configured (${r})`),e.targetCli==="claude"&&o.data){let i=o.data.subagentStatusLine;h(i?.command)?y(`${n} subagent rows: tokenline configured`):i!==void 0?s(`${n} subagent rows: another command (${W(i)})`):h(o.data.statusLine?.command)&&s(`${n} subagent rows: not configured (re-run init to add)`)}}console.log()}var j=require("fs"),X=require("path");var ft='TOKENLINE_VERSION=""',ht='TOKENLINE_UPDATE_CMD=""',bt=/^\d+\.\d+\.\d+$/;var I=t=>{let e="npx -y @inbrace-tech/tokenline@latest update";return t.targetCli==="antigravity"?`${e} --antigravity`:t.global?`${e} --global`:e};function Y(t,e,n){if(!bt.test(e))throw new Error(`Invalid version: ${e}`);if(n.includes("'"))throw new Error("Update command must not contain a single quote");let r=t.split(`
+`),o=(i,c)=>{let f=r.flatMap((C,T)=>C===i?[T]:[]);if(f.length!==1)throw new Error(`Expected exactly one "${i}" line in tokenline.sh`);r[f[0]]=c};return o(ft,`TOKENLINE_VERSION="${e}"`),o(ht,`TOKENLINE_UPDATE_CMD='${n}'`),r.join(`
+`)}function z(t){if(typeof t!="string")return null;let e=/^bash (?:"([^"$`\\]+)"|([^\s"'$`\\]+))$/.exec(t),n=e?e[1]??e[2]:void 0;return n!==void 0&&n.endsWith("/tokenline.sh")?n:null}var l=require("fs"),k=require("path");function _(t,e,n){let r=Y((0,l.readFileSync)(B,"utf8"),e,n);yt(t,r)}function yt(t,e){let n=(0,l.existsSync)(t)?(0,l.realpathSync)(t):t;(0,l.mkdirSync)((0,k.dirname)(n),{recursive:!0});let r=(0,k.join)((0,k.dirname)(n),`.${(0,k.basename)(n)}.${process.pid}.tmp`);(0,l.writeFileSync)(r,e,{flag:"wx",mode:493});try{(0,l.chmodSync)(r,493),(0,l.renameSync)(r,n)}catch(o){throw(0,l.rmSync)(r,{force:!0}),o}}function Q(t){a(`kept the existing subagentStatusLine (${JSON.stringify(t)}); re-run with --force to use tokenline for subagent rows.`)}function Z(t,e){if(console.log(u(`
 tokenline \u2014 installing the statusline
-`)),!T()&&!t.force){g("Unsupported platform. Re-run with --force to install anyway."),process.exitCode=1;return}N(),O();let o=w(t),r=p(t),d={type:"command",command:A(o),refreshInterval:1},c=m(r);if(c.exists&&c.data===null){g(`Could not parse ${r} (invalid JSON). Leaving it untouched.`),console.log(`
+`)),!N()&&!t.force){g("Unsupported platform. Re-run with --force to install anyway."),process.exitCode=1;return}E(),R();let r=w(t),o=m(t),i={type:"command",command:K(r),refreshInterval:1},c=p(o);if(c.exists&&c.data===null){g(`Could not parse ${o} (invalid JSON). Leaving it untouched.`),console.log(`
 Add this block manually, inside the top-level object:
-`),console.log(JSON.stringify({statusLine:d},null,2)+`
-`),process.exitCode=1;return}let f=c.data?c.data.statusLine:void 0,v=f!==void 0&&f.command===d.command,S=f!==void 0&&!v;if(S&&!t.force){g(`A different statusLine is already configured in ${r}:`),console.log(`    ${JSON.stringify(f)}`),l("Re-run with --force to replace it."),process.exitCode=1;return}if(t.dryRun){console.log(a(`
-[dry-run] would:`)),i(`write script  \u2192 ${o}`),i(`${c.exists?"patch":"create"} settings \u2192 ${r}`),c.exists&&i(`backup       \u2192 ${r}.bak`),console.log(`
+`);let U=t.targetCli==="claude"&&t.subagents?{statusLine:i,subagentStatusLine:{type:"command",command:i.command}}:{statusLine:i};console.log(JSON.stringify(U,null,2)+`
+`),process.exitCode=1;return}let f=c.data?c.data.statusLine:void 0,C=f!==void 0&&f.command===i.command,T=f!==void 0&&!C;if(T&&!t.force){g(`A different statusLine is already configured in ${o}:`),console.log(`    ${JSON.stringify(f)}`),a("Re-run with --force to replace it."),process.exitCode=1;return}let S=t.targetCli==="claude"&&t.subagents?{type:"command",command:i.command}:null,$=S?V(c.data?.subagentStatusLine,S.command,t.force):null;if(t.dryRun){console.log(u(`
+[dry-run] would:`)),s(`write script  \u2192 ${r}`),s(`${c.exists?"patch":"create"} settings \u2192 ${o}`),c.exists&&s(`backup       \u2192 ${o}.bak`),console.log(`
 statusLine block:
-${JSON.stringify(d,null,2)}
-`);return}R(o,e,E(t)),i(`wrote ${o} (v${e})`);let U=c.data??{};c.exists?(C(r),i(`backed up ${r} \u2192 settings.json.bak`)):(0,I.mkdirSync)((0,V.dirname)(r),{recursive:!0}),U.statusLine=d,(0,I.writeFileSync)(r,JSON.stringify(U,null,2)+`
-`),i(`${v?"confirmed":S?"replaced":"added"} statusLine in ${r}`);let Z=t.targetCli==="antigravity"?"Antigravity CLI":"Claude Code";console.log(`
-${h("Done.")} Restart ${Z} to see the statusline.
-`)}var $=require("fs");function G(t){console.log(a(`
+${JSON.stringify(i,null,2)}
+`),S&&$!=="keep"&&console.log(`subagentStatusLine block:
+${JSON.stringify(S,null,2)}
+`),$==="keep"&&Q(c.data?.subagentStatusLine);return}_(r,e,I(t)),s(`wrote ${r} (v${e})`);let P=c.data??{};if(c.exists?(O(o),s(`backed up ${o} \u2192 settings.json.bak`)):(0,j.mkdirSync)((0,X.dirname)(o),{recursive:!0}),P.statusLine=i,S&&$!=="keep"&&(P.subagentStatusLine=S),(0,j.writeFileSync)(o,JSON.stringify(P,null,2)+`
+`),s(`${C?"confirmed":T?"replaced":"added"} statusLine in ${o}`),$==="keep")Q(c.data?.subagentStatusLine);else if($!==null){let U={add:"added",confirm:"confirmed",replace:"replaced"}[$];s(`${U} subagentStatusLine in ${o}`)}let ut=t.targetCli==="antigravity"?"Antigravity CLI":"Claude Code";console.log(`
+${b("Done.")} Restart ${ut} to see the statusline.
+`)}var v=require("fs");function tt(t){console.log(u(`
 tokenline \u2014 uninstall
-`));let e=p(t),n=m(e);if(!n.exists||n.data===null?l(`No usable settings at ${e} \u2014 nothing to remove.`):L(n.data.statusLine?.command)?t.dryRun?i(`[dry-run] would remove statusLine from ${e}`):(C(e),delete n.data.statusLine,(0,$.writeFileSync)(e,JSON.stringify(n.data,null,2)+`
-`),i(`removed statusLine from ${e} (backup: settings.json.bak)`)):i(`No tokenline statusLine in ${e} \u2014 left untouched.`),t.purge){let r=w(t);(0,$.existsSync)(r)&&(t.dryRun?i(`[dry-run] would delete ${r}`):((0,$.unlinkSync)(r),i(`deleted ${r}`)))}let o=t.targetCli==="antigravity"?"Antigravity CLI":"Claude Code";console.log(`
-${h("Done.")} Restart ${o}.
-`)}var Y=require("fs");function z(t,e){console.log(a(`
+`));let e=m(t),n=p(e),r=(n.data?J({...n.data}):[]).join(" + ");if(!n.exists||n.data===null?a(`No usable settings at ${e} \u2014 nothing to remove.`):r!==""?t.dryRun?s(`[dry-run] would remove ${r} from ${e}`):(O(e),J(n.data),(0,v.writeFileSync)(e,JSON.stringify(n.data,null,2)+`
+`),s(`removed ${r} from ${e} (backup: settings.json.bak)`)):s(`No tokenline statusLine in ${e} \u2014 left untouched.`),t.purge){let i=w(t);(0,v.existsSync)(i)&&(t.dryRun?s(`[dry-run] would delete ${i}`):((0,v.unlinkSync)(i),s(`deleted ${i}`)))}let o=t.targetCli==="antigravity"?"Antigravity CLI":"Claude Code";console.log(`
+${b("Done.")} Restart ${o}.
+`)}var ot=require("fs");var et=require("path");function kt(t,e){let n=["npx -y @inbrace-tech/tokenline@latest init"];if(t.targetCli==="antigravity"?n.push("--antigravity"):t.global&&n.push("--global"),e!==w({...t,dir:null})){let r=(0,et.dirname)(e);n.push(r.includes(" ")?`--dir "${r}"`:`--dir ${r}`)}return n.join(" ")}function nt(t,e,n){return e.targetCli!=="claude"||t===null||t.subagentStatusLine!==void 0?null:kt(e,n)}function it(t,e){console.log(u(`
 tokenline \u2014 updating the statusline
-`));let n=p(t),o=m(n),r=M(o.data?.statusLine?.command);if(r===null||!(0,Y.existsSync)(r)){g(`No installed tokenline.sh found through ${n}.`);let d=t.targetCli==="antigravity"||t.global?"":" (or --global)";console.log(`
-Install it first: npx @inbrace-tech/tokenline init${d}
-`),process.exitCode=1;return}if(t.dryRun){i(`[dry-run] would overwrite ${r} with v${e}`);return}R(r,e,E(t)),i(`updated ${r} \u2192 v${e}`),console.log(`
-${h("Done.")} The statusline picks up the new version on its next refresh.
-`)}var P=JSON.parse((0,Q.readFileSync)((0,X.join)(__dirname,"..","package.json"),"utf8"));function lt(t){let e={_:[],targetCli:"claude",dir:null,global:!1,dryRun:!1,force:!1,purge:!1,help:!1,version:!1,unknown:[]};for(let n=0;n<t.length;n++){let o=t[n];switch(o){case"--dir":e.dir=t[++n]??null;break;case"--antigravity":e.targetCli="antigravity",e.global=!0;break;case"--global":e.global=!0;break;case"--dry-run":e.dryRun=!0;break;case"--force":e.force=!0;break;case"--purge":e.purge=!0;break;case"-h":case"--help":e.help=!0;break;case"-v":case"--version":e.version=!0;break;default:o!==void 0&&o.startsWith("-")?e.unknown.push(o):o!==void 0&&e._.push(o)}}return e}function H(){console.log(`
-${a("tokenline")} \u2014 a cache-aware statusline for AI coding CLIs
+`));let n=m(t),r=p(n),o=z(r.data?.statusLine?.command);if(o===null||!(0,ot.existsSync)(o)){g(`No installed tokenline.sh found through ${n}.`);let c=t.targetCli==="antigravity"||t.global?"":" (or --global)";console.log(`
+Install it first: npx @inbrace-tech/tokenline init${c}
+`),process.exitCode=1;return}let i=nt(r.data,t,o);if(t.dryRun){s(`[dry-run] would overwrite ${o} with v${e}`),i&&rt(i);return}_(o,e,I(t)),s(`updated ${o} \u2192 v${e}`),console.log(`
+${b("Done.")} The statusline picks up the new version on its next refresh.
+`),i&&rt(i)}function rt(t){a("Subagent rows are available but not wired in these settings."),console.log(`  Each subagent in the agent panel can show its own cache countdown.
+  Turn them on (your statusLine stays as is):
 
-${a("Usage")}
+    ${t}
+`)}function st(t){let e={_:[],targetCli:"claude",dir:null,global:!1,dryRun:!1,force:!1,purge:!1,subagents:!0,help:!1,version:!1,unknown:[]};for(let n=0;n<t.length;n++){let r=t[n];switch(r){case"--dir":e.dir=t[++n]??null;break;case"--antigravity":e.targetCli="antigravity",e.global=!0;break;case"--global":e.global=!0;break;case"--dry-run":e.dryRun=!0;break;case"--force":e.force=!0;break;case"--purge":e.purge=!0;break;case"--no-subagents":e.subagents=!1;break;case"-h":case"--help":e.help=!0;break;case"-v":case"--version":e.version=!0;break;default:r!==void 0&&r.startsWith("-")?e.unknown.push(r):r!==void 0&&e._.push(r)}}return e}var q=JSON.parse((0,lt.readFileSync)((0,ct.join)(__dirname,"..","package.json"),"utf8"));function at(){console.log(`
+${u("tokenline")} \u2014 a cache-aware statusline for AI coding CLIs
+
+${u("Usage")}
   npx @inbrace-tech/tokenline <command> [options]
 
-${a("Commands")}
+${u("Commands")}
   init          Install tokenline.sh and wire it into settings
   update        Replace the installed tokenline.sh with this version (run it as @latest)
   doctor        Check dependencies and current config \u2014 changes nothing
-  uninstall     Remove the tokenline statusLine block from settings
+  uninstall     Remove the tokenline blocks (statusLine, subagentStatusLine) from settings
 
-${a("Options")}
+${u("Options")}
   --antigravity Target Antigravity CLI (~/.gemini/antigravity-cli)
   --global      Target ~/.claude (global) instead of ./.claude (project)
   --dir <path>  Write tokenline.sh to a custom directory
   --dry-run     Show what would happen without writing anything
   --force       Proceed on an unsupported platform / replace an existing statusLine
   --purge       (uninstall) also delete the installed tokenline.sh
+  --no-subagents (init) skip the per-subagent cache rows in the agent panel
   -h, --help    Show this help
   -v, --version Show version
 
-${a("Notes")}
+${u("Notes")}
   The statusline runs as 'bash tokenline.sh' \u2014 no Node in the per-second hot path.
   jq is required at runtime; this installer checks for it but cannot install it.
-`)}function ct(){let t=lt(process.argv.slice(2));if(t.unknown.length>0&&t.unknown.forEach(e=>l(`ignoring unknown option: ${e}`)),t.version){console.log(P.version);return}if(t.help||t._.length===0){H();return}try{switch(t._[0]){case"init":W(t,P.version);break;case"update":z(t,P.version);break;case"doctor":B();break;case"uninstall":case"remove":G(t);break;default:g(`Unknown command: ${t._[0]}`),H(),process.exitCode=1}}catch(e){g(e instanceof Error?e.message:String(e)),process.exitCode=1}}ct();
+`)}function St(){let t=st(process.argv.slice(2));if(t.unknown.length>0&&t.unknown.forEach(e=>a(`ignoring unknown option: ${e}`)),t.version){console.log(q.version);return}if(t.help||t._.length===0){at();return}try{switch(t._[0]){case"init":Z(t,q.version);break;case"update":it(t,q.version);break;case"doctor":G();break;case"uninstall":case"remove":tt(t);break;default:g(`Unknown command: ${t._[0]}`),at(),process.exitCode=1}}catch(e){g(e instanceof Error?e.message:String(e)),process.exitCode=1}}St();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inbrace-tech/tokenline",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "A cache-aware statusline for AI coding CLIs — installs tokenline.sh and wires it into your Claude Code settings.",
   "bin": {
     "tokenline": "dist/cli.js"
@@ -40,18 +40,18 @@
     "@changesets/changelog-github": "1.0.1",
     "@changesets/cli": "^3.0.2",
     "@eslint/js": "10.0.1",
-    "@types/node": "24.13.5",
+    "@types/node": "24.19.2",
     "@vitest/eslint-plugin": "1.6.27",
-    "eslint": "10.10.0",
+    "eslint": "10.12.0",
     "eslint-config-prettier": "10.1.8",
-    "eslint-plugin-n": "18.3.0",
+    "eslint-plugin-n": "18.4.1",
     "eslint-plugin-prettier": "5.5.6",
     "eslint-plugin-simple-import-sort": "13.0.0",
-    "globals": "17.12.0",
-    "prettier": "3.9.8",
+    "globals": "17.13.0",
+    "prettier": "3.9.10",
     "tsup": "^8.5.1",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.70.0",
+    "typescript-eslint": "8.71.1",
     "vitest": "4.1.11"
   },
   "scripts": {

package/tokenline.sh

@@ -4,8 +4,10 @@
 # tokenline — a cache-aware statusline for AI coding CLIs
 #
 # Cross-CLI (Claude Code, Antigravity) and cross-provider (Anthropic, Gemini).
-# Renders: model · context · cache TTL (HOT/COLD) · per-turn token economics
+# Renders: model · effort · context · cache TTL (HOT/COLD) · per-turn token economics
 # (read / write / new / output / eq / saving %) · 5h + 7d rate-limit pacing.
+# Wired as Claude Code's subagentStatusLine, renders one row per subagent in
+# the agent panel instead, each with its own cache countdown (section 9).
 #
 # Repo:     https://github.com/inbrace-tech/tokenline
 # License:  MIT
@@ -97,12 +99,8 @@ mkdir -p "$_runtime_dir" 2>/dev/null && chmod 700 "$_runtime_dir" 2>/dev/null
 
 # --- 1. Parse JSON Standard Input and Prepare State Variables ---
 parse_and_prepare_paths() {
-  # Read full stdin JSON representing active session state from the CLI client
-  local input
-  input=$(cat)
-
   # Single jq execution to parse all required fields into an array at once (reduces forks)
-  mapfile -t _f < <(printf '%s' "$input" | jq -r '
+  mapfile -t _f < <(printf '%s' "$_input" | jq -r '
     (.model.display_name // ""),
     (.context_window.used_percentage // ""),
     (.context_window.context_window_size // ""),
@@ -116,7 +114,8 @@ parse_and_prepare_paths() {
     (.context_window.current_usage.output_tokens // 0),
     (.context_window.current_usage.cache_creation_input_tokens // 0),
     (.context_window.current_usage.cache_read_input_tokens // 0),
-    (.model.id // "")' 2>/dev/null)
+    (.model.id // ""),
+    (.effort.level // "")' 2>/dev/null)
 
   # Malformed or empty stdin: jq emits nothing, so the array is empty. Degrade to
   # a silent no-op render rather than leaking parse errors or rendering garbage —
@@ -137,6 +136,7 @@ parse_and_prepare_paths() {
   cur_cwrite="${_f[11]}"
   cur_cread="${_f[12]}"
   model_id="${_f[13]}"
+  effort_level="${_f[14]}"
 
   # Computed: total input-only tokens used in the current context window
   tokens_used=$((cur_input + cur_cwrite + cur_cread))
@@ -163,16 +163,27 @@ parse_and_prepare_paths() {
     is_gemini=true
   fi
 
+  # Gemini 4 Argon bills cache hits at 0.05x base input and output at 5x (the same
+  # ratios at the introductory and the regular price). Match the API id
+  # (gemini-4-argon) or a display name containing Argon; other Gemini models keep
+  # 0.25x / 4x.
+  is_gemini_argon=false
+  if [ "$is_gemini" = true ] && { [[ "${model_id,,}" == *argon* ]] || [[ "${model,,}" == *argon* ]]; }; then
+    is_gemini_argon=true
+  fi
+
   # Cache hits bill at 0.1x base input, except Claude Fable 5.1 / Mythos 5.1 (0.025x)
-  # and Claude Opus 5.5 (0.05x). Match the API id (claude-fable-5-1[1m]) or the
-  # display name (Fable 5.1) so either field alone is enough. Pin the full version:
-  # claude-opus-5 must stay 0.1x, and a later version's price is confirmed, not guessed.
+  # and Claude Opus 5.5 / Sonnet 5.5 (0.05x). Claude Haiku 5.5 is confirmed at 0.1x in
+  # both of its prompt-length price tiers. Match the API id (claude-fable-5-1[1m]) or
+  # the display name (Fable 5.1) so either field alone is enough. Pin the full version:
+  # claude-opus-5 / claude-sonnet-5 must stay 0.1x, and a later version's price is
+  # confirmed, not guessed.
   claude_read_mult="0.1"
   local fable_re='(fable|mythos)[- ]5[-.]1([^0-9]|$)'
-  local opus_re='opus[- ]5[-.]5([^0-9]|$)'
+  local half_re='(opus|sonnet)[- ]5[-.]5([^0-9]|$)'
   if [[ "${model_id,,}" =~ $fable_re ]] || [[ "${model,,}" =~ $fable_re ]]; then
     claude_read_mult="0.025"
-  elif [[ "${model_id,,}" =~ $opus_re ]] || [[ "${model,,}" =~ $opus_re ]]; then
+  elif [[ "${model_id,,}" =~ $half_re ]] || [[ "${model,,}" =~ $half_re ]]; then
     claude_read_mult="0.05"
   fi
 
@@ -333,6 +344,24 @@ compute_context_info() {
   fi
 }
 
+# --- 4b. Reasoning Effort ---
+compute_effort_info() {
+  # Claude Code sends the live session effort (it follows a mid-session /effort)
+  # and omits it for models without the effort parameter. Coloured by level so
+  # an effort left raised after a hard step stands out.
+  effort_info=""
+  [[ "$effort_level" =~ ^[A-Za-z0-9_-]+$ ]] || return 0
+  local effort_color
+  case "$effort_level" in
+    low|medium) effort_color="$COLOR_GREEN" ;;
+    high)       effort_color="$COLOR_YELLOW" ;;
+    xhigh)      effort_color="$COLOR_ORANGE" ;;
+    max)        effort_color="$COLOR_RED" ;;
+    *)          effort_color="$COLOR_GRAY" ;;
+  esac
+  effort_info=$(printf '%seffort: %s%s%s' "$COLOR_GRAY" "$effort_color" "$effort_level" "$COLOR_RESET")
+}
+
 # --- 5. Rate Limit Windows Heuristics and Bars ---
 rl_color_for_pct() {
   local pct=$1
@@ -435,6 +464,10 @@ compute_turn_breakdown() {
       write_mult="1.0"
       input_mult="1"
       output_mult="4"
+      if [ "$is_gemini_argon" = true ]; then
+        read_mult="0.05"
+        output_mult="5"
+      fi
     else
       read_mult="$claude_read_mult"
       write_mult="1.25"
@@ -492,9 +525,11 @@ version_gt() {
 
 compute_update_notice() {
   # Installed (stamped) copies only; the repo copy has no version and never checks.
-  # At most once per 24h a detached curl stores the latest published version in
-  # the private runtime dir, and the render path only reads that file. Nothing
-  # from the session is sent, and nothing downloaded is ever executed.
+  # A detached curl stores the latest published version in the private runtime
+  # dir, and the render path only reads that file. It runs when a session that
+  # hasn't checked yet finds the last check 1h+ old (so a new release shows up
+  # when you open a new session), and at least every 6h in a long session.
+  # Nothing from the session is sent, and nothing downloaded is ever executed.
   # Opt out with TOKENLINE_NO_UPDATE_CHECK=1 (DO_NOT_TRACK=1 is honored too).
   update_info=""
   local semver='^[0-9]+\.[0-9]+\.[0-9]+$'
@@ -505,12 +540,25 @@ compute_update_notice() {
   [ "$_runtime_dir" != "/tmp" ] && [ -O "$_runtime_dir" ] || return 0
 
   local latest_file="$_runtime_dir/latest-version"
-  local checked_at
+  local session_file="$_runtime_dir/latest-version.session"
+  local checked_at checked_by="" due=false age
   checked_at=$(file_mtime "$latest_file")
-  if { [ -z "$checked_at" ] || [ $((now - checked_at)) -ge 86400 ]; } \
-    && command -v curl >/dev/null 2>&1; then
-    # Mark the check first, so the refreshes during the fetch don't start another.
+  read -r checked_by 2>/dev/null < "$session_file"
+  if [ -z "$checked_at" ]; then
+    due=true
+  else
+    age=$((now - checked_at))
+    if [ "$age" -ge 21600 ]; then
+      due=true
+    elif [ "$age" -ge 3600 ] && [ -n "$session_id" ] && [ "$session_id" != "$checked_by" ]; then
+      due=true
+    fi
+  fi
+  if [ "$due" = true ] && command -v curl >/dev/null 2>&1; then
+    # Mark the check first (time and session), so the refreshes during the fetch
+    # don't start another one.
     touch "$latest_file" 2>/dev/null
+    printf '%s\n' "$session_id" 2>/dev/null > "$session_file"
     (
       v=$(curl -fsS --max-time 5 https://registry.npmjs.org/@inbrace-tech/tokenline/latest \
         | jq -r '.version // empty')
@@ -524,8 +572,12 @@ compute_update_notice() {
   read -r latest 2>/dev/null < "$latest_file"
   [[ "$latest" =~ $semver ]] || return 0
   version_gt "$latest" "$TOKENLINE_VERSION" || return 0
-  update_info=$(printf '%s↑ tokenline %s available · %s%s' \
-    "$COLOR_DARK_GRAY" "$latest" "$TOKENLINE_UPDATE_CMD" "$COLOR_RESET")
+  # In Claude Code, a leading "!" runs the command from the prompt, so the
+  # update never needs another terminal.
+  local run_hint=""
+  [ "$cli_client" = "claude-code" ] && run_hint="! "
+  update_info=$(printf '%s↑ tokenline %s available · update: %s%s%s' \
+    "$COLOR_DARK_GRAY" "$latest" "$run_hint" "$TOKENLINE_UPDATE_CMD" "$COLOR_RESET")
 }
 
 # --- 8. Compose and Render Output ---
@@ -540,6 +592,8 @@ render_statusline() {
     display_header="${model}"
   fi
 
+  [ -n "$effort_info" ] && display_header="$display_header · $effort_info"
+
   local line1="$display_header"
   [ -n "$ctx_info" ]   && line1="$line1 | $ctx_info"
   [ -n "$cache_info" ] && line1="$line1 | $cache_info"
@@ -564,10 +618,415 @@ render_statusline() {
   fi
 }
 
+# --- 9. Subagent Rows (subagentStatusLine) ---
+# Wired as `subagentStatusLine`, Claude Code runs this same script for its agent
+# panel: stdin is then {session_id, transcript_path, columns, tasks: [...]} and
+# stdout is one {"id","content"} JSON line per row. Each row carries that
+# subagent's own prompt-cache countdown, read from its own transcript.
+# Subagent requests write the 5-minute cache, so a subagent that waits on a long
+# tool call (a test suite, a build) or on a human answer goes COLD quietly, and
+# its next turn pays a full cache write instead of a cache read.
+
+_sa_sep=$'\x1f'
+# Bump when scan_subagent_transcript's output changes (see load_subagent_state).
+_sa_scan_version=3
+
+# LC_ALL=C (top of file) makes ${#s} count bytes, so 'é' or '…' would throw the
+# columns off. Width math switches to a UTF-8 locale when one exists; without
+# one it falls back to bytes, which only over-counts (rows get shorter, never
+# wider than the panel).
+_utf8_locale=""
+probe_utf8_locale() {
+  local loc
+  for loc in C.UTF-8 C.utf8 en_US.UTF-8 en_US.utf8 UTF-8; do
+    if { _utf8_len_probe "$loc"; } 2>/dev/null; then
+      _utf8_locale="$loc"
+      return
+    fi
+  done
+}
+_utf8_len_probe() {
+  local LC_ALL="$1" s='é'
+  [ "${#s}" -eq 1 ]
+}
+
+strip_ansi() {
+  # SGR sequences only: the only escapes this script ever emits.
+  local s="$1" re=$'\033''\[[0-9;]*m'
+  while [[ "$s" =~ $re ]]; do s="${s/"${BASH_REMATCH[0]}"/}"; done
+  printf '%s' "$s"
+}
+
+vis_len() {
+  # Visible width of a (possibly colored) string, in characters.
+  local plain; plain=$(strip_ansi "$1")
+  { local LC_ALL="${_utf8_locale:-C}"; } 2>/dev/null
+  printf '%s' "${#plain}"
+}
+
+fit() {
+  # Plain text cut to $2 characters, with a trailing ellipsis when cut.
+  local s="$1" n="$2"
+  { local LC_ALL="${_utf8_locale:-C}"; } 2>/dev/null
+  if [ "$n" -le 0 ]; then return; fi
+  if [ "${#s}" -le "$n" ]; then printf '%s' "$s"; return; fi
+  if [ -n "$_utf8_locale" ]; then
+    printf '%s…' "${s:0:n-1}"
+  else
+    printf '%s' "${s:0:n}"
+  fi
+}
+
+pad() {
+  # Right-pads a colored string to $2 visible characters.
+  local s="$1" w="$2" len
+  len=$(vis_len "$s")
+  printf '%s%*s' "$s" $((w > len ? w - len : 0)) ''
+}
+
+fmt_elapsed() {
+  local s=${1:-0}
+  if   [ "$s" -lt 60 ];   then printf '%ds' "$s"
+  elif [ "$s" -lt 3600 ]; then printf '%dm%02ds' $((s / 60)) $((s % 60))
+  else                         printf '%dh%02dm' $((s / 3600)) $(((s % 3600) / 60))
+  fi
+}
+
+# Scans one subagent transcript for: the last assistant turn's timestamp (the
+# moment its cache was last touched), the TTL its cache writes used, and its
+# last tool call — "waiting" when that call has no result yet. Lines are parsed
+# one by one with fromjson?, so the half-written line at the end of a live
+# transcript is skipped instead of failing the whole scan.
+scan_subagent_transcript() {
+  tail -n 400 "$1" 2>/dev/null | jq -Rrn '
+    [inputs | fromjson? | select(type == "object")] as $all
+    | [$all[] | select(.type == "assistant")] as $a
+    | ([$a[] | .message.usage.cache_creation // {}
+        | if (.ephemeral_1h_input_tokens // 0) > 0 then "1h"
+          elif (.ephemeral_5m_input_tokens // 0) > 0 then "5m"
+          else empty end] | last // "") as $ttl
+    | ([$a[] | .message.content[]? | select(.type == "tool_use")] | last) as $call
+    | ($call.name // "") as $tool
+    | ([$all[] | select(.type == "assistant" or .type == "user")]) as $turns
+    | ($turns | last) as $tail
+    | (if $tail.type == "assistant"
+          and ([$tail.message.content[]? | select(.type == "tool_use")] | length) > 0
+       then "waiting"
+       # A background call answers at once ("running in background"); the
+       # subagent may say a line, then idles until the job reports. Until a new
+       # user entry that is not a tool result (the job notification) arrives,
+       # it is still waiting — just not inside a call.
+       elif ($call.input.run_in_background == true)
+          and ([$turns | to_entries[]
+                | select(.value.type == "assistant"
+                    and ([.value.message.content[]? | select(.type == "tool_use")] | length) > 0)
+                | .key] | last) as $at
+          | ($turns[($at + 1):]
+             | all(.type == "assistant"
+                   or ([.message.content[]? | select(.type == "tool_result")] | length) > 0))
+       then "waiting-bg"
+       else "last" end) as $mode
+    | [($a | last | .timestamp // ""), $ttl, $tool, $mode]
+    | map(tostring | gsub("[[:cntrl:]]"; " "))
+    | join("\u001f")' 2>/dev/null
+}
+
+# Sets sa_last_ts / sa_ttl_label / sa_tool / sa_mode for one subagent. The scan
+# result is kept per subagent in the private runtime dir, keyed on the
+# transcript's mtime, so an unchanged transcript costs one stat per refresh
+# instead of a tail + jq.
+load_subagent_state() {
+  local aid="$1" dir="$2"
+  sa_last_ts="" sa_ttl_label="" sa_tool="" sa_mode=""
+
+  local transcript="" candidate
+  if [ -f "$dir/agent-$aid.jsonl" ]; then
+    transcript="$dir/agent-$aid.jsonl"
+  else
+    # Workflow-spawned agents live one level down: subagents/workflows/<run>/.
+    for candidate in "$dir"/workflows/*/"agent-$aid.jsonl"; do
+      [ -f "$candidate" ] && { transcript="$candidate"; break; }
+    done
+  fi
+  [ -n "$transcript" ] && [ -r "$transcript" ] || return 0
+
+  # mtime alone has 1s resolution, so a line appended within the second of the
+  # last scan would be missed: key on mtime and size together (one stat call).
+  local mtime
+  if [ "$_stat_gnu" -eq 1 ]; then
+    mtime=$(stat -c '%Y:%s' "$transcript" 2>/dev/null)
+  else
+    mtime=$(stat -f '%m:%z' "$transcript" 2>/dev/null)
+  fi
+  local state_file=""
+  if [ "$_runtime_private" = true ] && [ -n "$sa_session_key" ]; then
+    # The version tag retires every cached scan when the scan itself changes,
+    # so an updated script never serves a result the old one computed.
+    state_file="$_runtime_dir/sa$_sa_scan_version-$sa_session_key-$aid"
+  fi
+
+  local s_mtime="" s_ts="" s_ttl="" s_tool="" s_mode=""
+  if [ -n "$state_file" ] && [ -f "$state_file" ]; then
+    IFS="$_sa_sep" read -r s_mtime s_ts s_ttl s_tool s_mode < "$state_file"
+  fi
+
+  if [ -n "$mtime" ] && [ "$mtime" = "$s_mtime" ]; then
+    sa_last_ts="$s_ts" sa_ttl_label="$s_ttl" sa_tool="$s_tool" sa_mode="$s_mode"
+    return 0
+  fi
+
+  local iso ttl tool mode
+  IFS="$_sa_sep" read -r iso ttl tool mode < <(scan_subagent_transcript "$transcript")
+  [ -n "$iso" ] && sa_last_ts=$(epoch_from_iso "$iso")
+  # A turn that only read the cache reports no write TTL: keep the last known one.
+  sa_ttl_label="${ttl:-$s_ttl}"
+  sa_tool="$tool"
+  sa_mode="$mode"
+
+  if [ -n "$state_file" ]; then
+    printf '%s\n' "$mtime$_sa_sep$sa_last_ts$_sa_sep$sa_ttl_label$_sa_sep$sa_tool$_sa_sep$sa_mode" \
+      > "$state_file" 2>/dev/null
+  fi
+}
+
+subagent_cache_segment() {
+  # Same wording and gradient as the main line's cache segment. A finished
+  # subagent's countdown still matters (it can be resumed), but it never
+  # blinks: the alarm is reserved for a running subagent going cold.
+  local status="$1"
+  if [ -z "$sa_last_ts" ]; then
+    printf '%scache: --%s' "$COLOR_DARK_GRAY" "$COLOR_RESET"
+    return
+  fi
+  local label="${sa_ttl_label:-5m}" ttl=300
+  [ "$label" = "1h" ] && ttl=3600
+  local remaining=$((ttl - (now - sa_last_ts)))
+  local active=false
+  [ "$status" = "running" ] && active=true
+
+  if [ "$remaining" -gt 0 ]; then
+    local pct10=$((remaining * 10 / ttl)) fg
+    if   [ "$pct10" -ge 8 ]; then fg="$COLOR_GREEN"
+    elif [ "$pct10" -ge 6 ]; then fg=$'\033[38;5;154m'
+    elif [ "$pct10" -ge 4 ]; then fg="$COLOR_YELLOW"
+    elif [ "$pct10" -ge 2 ]; then fg="$COLOR_ORANGE"
+    elif [ "$pct10" -ge 1 ] || [ "$active" = false ]; then fg="$COLOR_RED"
+    else fg="${COLOR_RED}${STYLE_BLINK}"
+    fi
+    printf '%s[%s] cache: %s%d:%02d HOT%s' "$COLOR_GRAY" "$label" "$fg" \
+      $((remaining / 60)) $((remaining % 60)) "$COLOR_RESET"
+  elif [ "$active" = true ]; then
+    printf '%s[%s] cache: %s%sCOLD%s' "$COLOR_GRAY" "$label" "$STYLE_BLINK" "$COLOR_RED" "$COLOR_RESET"
+  else
+    printf '%s[%s] cache: cold%s' "$COLOR_DARK_GRAY" "$label" "$COLOR_RESET"
+  fi
+}
+
+short_model() {
+  # claude-haiku-4-5-20251001 -> haiku 4.5, claude-opus-5-5[1m] -> opus 5.5,
+  # us.anthropic.claude-sonnet-5 -> sonnet 5. Anything else is shown as sent.
+  local m="${1##*claude-}"
+  m="${m%%\[*}"
+  [[ "$m" =~ ^(.*)-[0-9]{8}$ ]] && m="${BASH_REMATCH[1]}"
+  if   [[ "$m" =~ ^([a-z]+)-([0-9]+)-([0-9]+)$ ]]; then m="${BASH_REMATCH[1]} ${BASH_REMATCH[2]}.${BASH_REMATCH[3]}"
+  elif [[ "$m" =~ ^([a-z]+)-([0-9]+)$ ]];          then m="${BASH_REMATCH[1]} ${BASH_REMATCH[2]}"
+  fi
+  printf '%s' "$m"
+}
+
+status_glyph() {
+  case "$1" in
+    running)          printf '%s●%s' $'\033[38;5;39m' "$COLOR_RESET" ;;
+    completed)        printf '%s✓%s' "$COLOR_GREEN" "$COLOR_RESET" ;;
+    failed|error)     printf '%s✗%s' "$COLOR_RED" "$COLOR_RESET" ;;
+    stopped|killed)   printf '%s■%s' "$COLOR_GRAY" "$COLOR_RESET" ;;
+    *)                printf '%s·%s' "$COLOR_GRAY" "$COLOR_RESET" ;;
+  esac
+}
+
+render_subagent_rows() {
+  # $1: the payload's jq extraction (header line, then one line per task).
+  local header rows=()
+  { IFS= read -r header; mapfile -t rows; } <<< "$1"
+
+  local session_id_in parent_transcript columns
+  IFS="$_sa_sep" read -r _ session_id_in parent_transcript columns <<< "$header"
+  [[ "$columns" =~ ^[0-9]+$ ]] || columns="${COLUMNS:-100}"
+  [[ "$columns" =~ ^[0-9]+$ ]] || columns=100
+
+  # Ids end up in file names: accept only a conservative alphabet.
+  local safe='^[A-Za-z0-9_-]+$'
+  sa_session_key=""
+  [[ "$session_id_in" =~ $safe ]] && sa_session_key="$session_id_in"
+  local subagents_dir=""
+  [ -n "$parent_transcript" ] && subagents_dir="${parent_transcript%.jsonl}/subagents"
+
+  _runtime_private=false
+  [ "$_runtime_dir" != "/tmp" ] && [ -O "$_runtime_dir" ] && _runtime_private=true
+
+  now=$(date +%s)
+  probe_utf8_locale
+
+  # Pass 1: build every row's segments, tracking each column's widest cell so
+  # the rows line up under each other.
+  local -a ids types glyphs models efforts elapsed ctx cache activity descs
+  local w_type=0 w_model=0 w_effort=0 w_elapsed=0 w_ctx=0 w_cache=0 w_act=0
+  local line id name type status desc start_ms tokens window model effort aid
+  for line in "${rows[@]}"; do
+    IFS="$_sa_sep" read -r id name type status desc start_ms tokens window model effort <<< "$line"
+    [ -z "$id" ] && continue
+
+    aid="${id#agent-}"
+    sa_last_ts="" sa_ttl_label="" sa_tool="" sa_mode=""
+    if [[ "$aid" =~ $safe ]] && [ -n "$subagents_dir" ]; then
+      load_subagent_state "$aid" "$subagents_dir"
+    fi
+    # Claude Code reports a subagent idling on its own background job as
+    # "completed": its turn ended. It resumes when the job reports, so its
+    # cache still matters — show it as running (activity, blinking COLD).
+    [ "$sa_mode" = "waiting-bg" ] && status="running"
+
+    local t="${type:-$name}"
+    t=$(fit "${t:-agent}" 24)
+
+    # A finished subagent's clock stops at its last turn, not at "now".
+    local el="" until="$now"
+    [ "$status" != "running" ] && [ -n "$sa_last_ts" ] && until="$sa_last_ts"
+    if [[ "$start_ms" =~ ^[0-9]+$ ]] && [ "$start_ms" -gt 0 ]; then
+      local secs=$((until - start_ms / 1000))
+      [ "$secs" -lt 0 ] && secs=0
+      el=$(printf '%s%s%s' "$COLOR_GRAY" "$(fmt_elapsed "$secs")" "$COLOR_RESET")
+    fi
+
+    local cx=""
+    if [[ "$tokens" =~ ^[0-9]+$ ]] && [ "$tokens" -gt 0 ]; then
+      if [[ "$window" =~ ^[0-9]+$ ]] && [ "$window" -gt 0 ]; then
+        local pct=$((tokens * 100 / window)) cc=$'\033[01;32m'
+        if   [ "$pct" -ge 80 ]; then cc=$'\033[01;31m'
+        elif [ "$pct" -ge 50 ]; then cc=$'\033[01;33m'
+        fi
+        cx=$(printf '%sctx: %s%s (%d%%)%s' "$COLOR_GRAY" "$cc" "$(fmt_k "$tokens")" "$pct" "$COLOR_RESET")
+      else
+        cx=$(printf '%sctx: %s%s' "$COLOR_GRAY" "$(fmt_k "$tokens")" "$COLOR_RESET")
+      fi
+    fi
+
+    local act=""
+    if [ -n "$sa_tool" ] && [ "$status" = "running" ]; then
+      if [ "$sa_mode" = "waiting" ]; then
+        act=$(printf '%swaiting: %s%s' "$COLOR_YELLOW" "$(fit "$sa_tool" 16)" "$COLOR_RESET")
+      elif [ "$sa_mode" = "waiting-bg" ]; then
+        act=$(printf '%swaiting: %s (bg)%s' "$COLOR_YELLOW" "$(fit "$sa_tool" 16)" "$COLOR_RESET")
+      else
+        act=$(printf '%slast: %s%s' "$COLOR_DARK_GRAY" "$(fit "$sa_tool" 16)" "$COLOR_RESET")
+      fi
+    fi
+
+    local cs; cs=$(subagent_cache_segment "$status")
+
+    # Model is absent until Claude Code resolves it; effort is absent when the
+    # subagent inherits the session's. Both stay blank rather than guessed.
+    local md="" ef=""
+    [ -n "$model" ] && md=$(printf '%s%s%s' "$COLOR_CYAN" "$(fit "$(short_model "$model")" 14)" "$COLOR_RESET")
+    if [[ "$effort" =~ ^[0-9]+$ ]]; then
+      # A numeric effort is a thinking-token budget; "tok" keeps it from
+      # reading as a token count.
+      local budget; budget=$(fmt_k "$effort")
+      ef=$(printf '%s%s tok%s' "$COLOR_GRAY" "${budget/.0k/k}" "$COLOR_RESET")
+    elif [ -n "$effort" ]; then
+      ef=$(printf '%s%s%s' "$COLOR_GRAY" "$(fit "$effort" 8)" "$COLOR_RESET")
+    fi
+
+    ids+=("$id"); types+=("$t"); glyphs+=("$(status_glyph "$status")")
+    models+=("$md"); efforts+=("$ef")
+    elapsed+=("$el"); ctx+=("$cx"); cache+=("$cs"); activity+=("$act"); descs+=("$desc")
+
+    local l
+    l=$(vis_len "$t");   [ "$l" -gt "$w_type" ]    && w_type=$l
+    l=$(vis_len "$md");  [ "$l" -gt "$w_model" ]   && w_model=$l
+    l=$(vis_len "$ef");  [ "$l" -gt "$w_effort" ]  && w_effort=$l
+    l=$(vis_len "$el");  [ "$l" -gt "$w_elapsed" ] && w_elapsed=$l
+    l=$(vis_len "$cx");  [ "$l" -gt "$w_ctx" ]     && w_ctx=$l
+    l=$(vis_len "$cs");  [ "$l" -gt "$w_cache" ]   && w_cache=$l
+    l=$(vis_len "$act"); [ "$l" -gt "$w_act" ]     && w_act=$l
+  done
+
+  # Pass 2: fit to the panel width. Type, status and cache always stay (the
+  # cache countdown is the point of the row); the type name shrinks when even
+  # those three don't fit. Optional columns are admitted whole, most useful
+  # first — activity (what a cold cache is waiting on), elapsed, context,
+  # model, effort — so every row keeps the same layout, and the description
+  # takes what is left. A column no row has a value for takes no space.
+  local i
+  local max_type=$((columns - 5 - w_cache))
+  [ "$max_type" -lt 4 ] && max_type=4
+  if [ "$w_type" -gt "$max_type" ]; then
+    w_type=$max_type
+    for i in "${!types[@]}"; do types[i]=$(fit "${types[i]}" "$w_type"); done
+  fi
+  local fixed=$((w_type + 2 + 1 + 2 + w_cache))
+  local show_el=false show_ctx=false show_act=false show_model=false show_effort=false
+  [ "$w_act" -gt 0 ] && [ $((fixed + 2 + w_act)) -le "$columns" ] && { show_act=true; fixed=$((fixed + 2 + w_act)); }
+  [ "$w_elapsed" -gt 0 ] && [ $((fixed + 2 + w_elapsed)) -le "$columns" ] && { show_el=true; fixed=$((fixed + 2 + w_elapsed)); }
+  [ "$w_ctx" -gt 0 ] && [ $((fixed + 2 + w_ctx)) -le "$columns" ] && { show_ctx=true; fixed=$((fixed + 2 + w_ctx)); }
+  [ "$w_model" -gt 0 ] && [ $((fixed + 2 + w_model)) -le "$columns" ] && { show_model=true; fixed=$((fixed + 2 + w_model)); }
+  [ "$w_effort" -gt 0 ] && [ $((fixed + 2 + w_effort)) -le "$columns" ] && { show_effort=true; fixed=$((fixed + 2 + w_effort)); }
+  local desc_room=$((columns - fixed - 2))
+
+  local out content
+  out=""
+  for i in "${!ids[@]}"; do
+    content="$(printf '%s' $'\033[38;5;141m')$(pad "${types[i]}" "$w_type")${COLOR_RESET}  ${glyphs[i]}"
+    [ "$show_model" = true ]  && content+="  $(pad "${models[i]}" "$w_model")"
+    [ "$show_effort" = true ] && content+="  $(pad "${efforts[i]}" "$w_effort")"
+    [ "$show_el" = true ]  && content+="  $(pad "${elapsed[i]}" "$w_elapsed")"
+    [ "$show_ctx" = true ] && content+="  $(pad "${ctx[i]}" "$w_ctx")"
+    content+="  $(pad "${cache[i]}" "$w_cache")"
+    [ "$show_act" = true ] && content+="  $(pad "${activity[i]}" "$w_act")"
+    if [ "$desc_room" -ge 8 ] && [ -n "${descs[i]}" ]; then
+      content+="  ${COLOR_GRAY}$(fit "${descs[i]}" "$desc_room")${COLOR_RESET}"
+    fi
+    # Trailing padding is noise in a row the host renders as-is.
+    while [[ "$content" == *' ' ]]; do content="${content% }"; done
+    out+="${ids[i]}$_sa_sep$content"$'\n'
+  done
+
+  # One jq call encodes every row as JSON (escapes, ANSI and all).
+  [ -n "$out" ] && printf '%s' "$out" \
+    | jq -Rc 'split("\u001f") | {id: .[0], content: (.[1] // "")}' 2>/dev/null
+}
+
+# Runs the subagent renderer when the payload carries a `tasks` array. The cheap
+# substring test keeps the main statusline at a single jq call per refresh; the
+# jq below is the authoritative check, so a main payload that merely mentions
+# "tasks" in some string still falls through to the main render.
+maybe_render_subagents() {
+  [[ "$_input" == *'"tasks"'* ]] || return 1
+  local extracted
+  extracted=$(printf '%s' "$_input" | jq -r '
+    def clean: tostring | gsub("[[:cntrl:]]"; " ");
+    if type == "object" and (.tasks | type) == "array" then
+      ([ "subagents", (.session_id // ""), (.transcript_path // ""), (.columns // "") ]
+        | map(clean) | join("\u001f")),
+      (.tasks[] | select(type == "object")
+        | [ (.id // ""), (.name // ""), (.type // ""), (.status // ""),
+            (.description // .label // ""), (.startTime // 0),
+            (.tokenCount // 0), (.contextWindowSize // 0),
+            (.model // ""), (.effort // "") ]
+        | map(clean) | join("\u001f"))
+    else empty end' 2>/dev/null)
+  [[ "$extracted" == subagents* ]] || return 1
+  render_subagent_rows "$extracted"
+  return 0
+}
+
 # --- Orchestrated Execution Flow ---
+_input=$(cat)
+maybe_render_subagents && exit 0
 parse_and_prepare_paths
 compute_cache_timer
 compute_context_info
+compute_effort_info
 compute_rate_limits
 compute_turn_breakdown
 compute_update_notice