@litfamily/litclaude 1.0.24 → 1.0.25

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.0.25 - 2026-10-12
+
+- The LIT card now moves while LitClaude is at work, so a glance tells you it is busy. The LIT pill and the border slowly glow from pink to flame orange and back, a light passes over the current phase and the skill chips of this request, and a spark runs along the top edge and back along the bottom one. When the turn ends the card goes still again. With the `motion` setting at `subtle` only the glow stays, and `off` keeps the card still.
+- The card is wider. It now grows with the terminal up to 120 columns instead of 80.
+- The bottom edge shows the weekly usage window next to the five-hour one, as the status line does.
+- The installer sets up the Claude desktop app too. The app's Code tab reads the same settings as the terminal but has no editor for the card's options, so the installer now writes the defaults for `motion`, `glyphs` and `band`, keeping any value you already chose. The new `litclaude-ai config` command shows them, and `litclaude-ai config <option> <value>` changes one from a terminal. Uninstall removes only the defaults it wrote that you never changed.
+- The README demo film now opens on a title card and names each step with a numbered two-line caption, and the card pictures show the new width and the weekly window.
+
 ## 1.0.24 - 2026-10-12
 
 - The LIT card no longer drops to idle while background work is still running. When the main turn ends after starting background subagents or a workflow, the card stays at work and counts the running agents until the last one finishes, and it never reads `DONE` while an agent is still busy. A workflow's agents now count too, and a subagent that finishes in the middle of a turn no longer dims the chips of the request that is still running. An agent that never reports back stops counting after 30 quiet minutes, so it cannot hold the card at work.

package/README.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">A Claude Code plugin that helps every session plan the work, build it, check it, and leave a note the next session can pick up.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/readme/badge-version.svg" alt="1.0.24" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/readme/badge-version.svg" alt="1.0.25" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/README_ko-KR.md">한국어</a>
+  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/README_ko-KR.md">한국어</a>
 </p>
 
 Add `lit` to a Claude Code prompt and Claude pins the goal, writes a failing test first,
@@ -73,7 +73,7 @@ the `/plugin` menu.
 ## More
 
 - [Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litclaude#readme)
-- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/privacy.md)
-- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/CHANGELOG.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/LICENSE)
+- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/privacy.md)
+- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/CHANGELOG.md)
+- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/LICENSE)

package/README_ko-KR.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">Claude Code에서 세션마다 계획하고, 만들고, 확인한 뒤 다음 세션이 이어받을 기록을 남기게 돕는 플러그인입니다.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/readme/badge-version.svg" alt="1.0.24" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/readme/badge-version.svg" alt="1.0.25" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/README.md">English</a>
+  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/README.md">English</a>
 </p>
 
 Claude Code 프롬프트에 `lit`을 붙이면 Claude가 목표를 고정하고, 실패하는 테스트를 먼저 쓰고,
@@ -71,7 +71,7 @@ LitClaude는 프로젝트 상태를 `.litclaude/`에 두고, 그 안의 `.gitign
 ## 더 보기
 
 - [전체 안내와 스킬 갤러리 (GitHub)](https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md)
-- [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/privacy.md)
-- [이전과 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/docs/migration.md)
-- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/CHANGELOG.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.24/LICENSE)
+- [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/privacy.md)
+- [이전과 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/docs/migration.md)
+- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/CHANGELOG.md)
+- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.25/LICENSE)

package/bin/litclaude-ai.js

@@ -30,6 +30,7 @@ import {
   themeForAccent,
 } from "../plugins/litclaude/lib/hud-accent-palette.mjs";
 import { readPublicSource } from "../plugins/litclaude/lib/public-source-reader/reader.mjs";
+import { MOD_CHOICES } from "../plugins/litclaude/lib/mod/settings.mjs";
 import { verifyBundledSkillsIntegrity } from "../plugins/litclaude/lib/bundled-skills-integrity.mjs";
 import { verifyCanonicalFrontendCorpus } from "../plugins/litclaude/lib/canonical-frontend-corpus.mjs";
 import { verifyCanonicalRuntimeClosures } from "../plugins/litclaude/lib/canonical-runtime-closures.mjs";
@@ -80,12 +81,16 @@ const prewarmMotionRuntime = () => {
 };
 const version = packageJson.version;
 
-const usage = `Usage: litclaude-ai [--dry-run] <install|doctor|path|run|update|uninstall|litgoal|wikify|workflow-check|start-work|start-work-next|public-read|motion-runtime> [...args]
+const usage = `Usage: litclaude-ai [--dry-run] <install|doctor|config|path|run|update|uninstall|litgoal|wikify|workflow-check|start-work|start-work-next|public-read|motion-runtime> [...args]
        litclaude-ai --version
 
 Commands:
   install       Register the packaged LitClaude plugin in Claude Code.
   doctor        Validate the installed LitClaude plugin path.
+  config [<option> <value>]
+                Show or change the LIT card options (motion, glyphs, band) in
+                pluginConfigs, the same values /config edits. Works for the
+                desktop app too, which shows no editor for them.
   path          Print the installed Claude plugin path.
   run -- ...    Run Claude Code after the global plugin install.
   litgoal       Manage litgoal runtime state and evidence.
@@ -720,6 +725,82 @@ const registerMarketplace = (marketplacePath, home = claudeHome()) => {
   writeKnownMarketplaces(knownMarketplaces, home);
 };
 
+// The LIT card's options live in settings.json `pluginConfigs`, which the terminal and the desktop
+// app both read; the desktop app has no editor for them, so install writes each default the user
+// has not set and records which ones it wrote. Uninstall removes only those still at that value.
+const modOptionDefaults = () => Object.fromEntries(Object.keys(MOD_CHOICES).map((key) => [key, MOD_CHOICES[key][0]]));
+const modOptionsOf = (settings) => ({ ...modOptionDefaults(), ...(settings.pluginConfigs?.[pluginKey]?.options ?? {}) });
+const modOptionsLine = (settings) => {
+  const options = modOptionsOf(settings);
+  return Object.keys(MOD_CHOICES).map((key) => `${key} ${options[key]}`).join(" · ");
+};
+
+const writeModOptions = (settings, options) => {
+  settings.pluginConfigs = settings.pluginConfigs ?? {};
+  const entry = settings.pluginConfigs[pluginKey] ?? {};
+  settings.pluginConfigs[pluginKey] = { ...entry, options: { ...(entry.options ?? {}), ...options } };
+};
+
+const installModOptions = (home = claudeHome()) => {
+  const settings = readClaudeSettings(home);
+  const present = settings.pluginConfigs?.[pluginKey]?.options ?? {};
+  const existingLitClaude = settings[litClaudeSettingsKey] ?? {};
+  const written = { ...(existingLitClaude.modOptionsWritten ?? {}) };
+  const missing = Object.fromEntries(Object.entries(modOptionDefaults()).filter(([key]) => present[key] === undefined));
+  if (Object.keys(missing).length === 0) return;
+  writeModOptions(settings, missing);
+  settings[litClaudeSettingsKey] = { ...existingLitClaude, modOptionsWritten: { ...written, ...missing } };
+  writeClaudeSettings(settings, home);
+};
+
+const uninstallModOptions = (home = claudeHome()) => {
+  if (!existsSync(claudeSettingsPath(home))) return;
+  const settings = readClaudeSettings(home);
+  const litClaude = settings[litClaudeSettingsKey];
+  if (!litClaude?.modOptionsWritten) return;
+  const entry = settings.pluginConfigs?.[pluginKey];
+  if (entry?.options) {
+    const options = { ...entry.options };
+    for (const [key, value] of Object.entries(litClaude.modOptionsWritten)) if (options[key] === value) delete options[key];
+    const rest = { ...entry };
+    if (Object.keys(options).length > 0) rest.options = options;
+    else delete rest.options;
+    if (Object.keys(rest).length > 0) settings.pluginConfigs[pluginKey] = rest;
+    else delete settings.pluginConfigs[pluginKey];
+    if (Object.keys(settings.pluginConfigs).length === 0) delete settings.pluginConfigs;
+  }
+  const remainingLitClaude = { ...litClaude };
+  delete remainingLitClaude.modOptionsWritten;
+  if (Object.keys(remainingLitClaude).length > 0) settings[litClaudeSettingsKey] = remainingLitClaude;
+  else delete settings[litClaudeSettingsKey];
+  writeClaudeSettings(settings, home);
+};
+
+// `config` prints the options; `config <option> <value>` sets one. A value the user sets is theirs,
+// so it leaves the install record and uninstall keeps it.
+const configModOptions = (rest, home = claudeHome()) => {
+  if (rest.length === 0) {
+    const options = modOptionsOf(readClaudeSettings(home));
+    for (const key of Object.keys(MOD_CHOICES)) process.stdout.write(`${key.padEnd(7)} ${options[key].padEnd(7)} (${MOD_CHOICES[key].join(", ")})\n`);
+    process.stdout.write("Change one with: litclaude-ai config <option> <value>. New Claude Code sessions, terminal or desktop app, pick it up.\n");
+    return;
+  }
+  const [key, raw] = rest;
+  if (!Object.hasOwn(MOD_CHOICES, key)) fail(`Unknown option: ${key}. Options: ${Object.keys(MOD_CHOICES).join(", ")}`, 64);
+  const value = String(raw ?? "").trim().toLowerCase();
+  if (!MOD_CHOICES[key].includes(value) || rest.length > 2) fail(`${key} takes one of: ${MOD_CHOICES[key].join(", ")}`, 64);
+  const settings = readClaudeSettings(home);
+  writeModOptions(settings, { [key]: value });
+  const litClaude = settings[litClaudeSettingsKey];
+  if (litClaude?.modOptionsWritten && Object.hasOwn(litClaude.modOptionsWritten, key)) {
+    const written = { ...litClaude.modOptionsWritten };
+    delete written[key];
+    settings[litClaudeSettingsKey] = { ...litClaude, modOptionsWritten: written };
+  }
+  writeClaudeSettings(settings, home);
+  process.stdout.write(`MOD_OPTIONS: ${modOptionsLine(settings)}\n`);
+};
+
 const ownsHudStatusLine = (settings, ownership) =>
   settings.statusLine?.type === "command" && settings.statusLine.command === ownership.statusLineCommand &&
   Object.keys(settings.statusLine).every((key) => key === "type" || key === "command");
@@ -1025,6 +1106,7 @@ const registerClaudePlugin = (installRoot, marketplacePath, home = claudeHome(),
   writeInstalledPlugins(registry, home);
   registerMarketplace(marketplacePath, home);
   installHudStatusLine(installRoot, home, hudAccent);
+  installModOptions(home);
   recordPermissionConfiguration(permissionMode, home);
 };
 
@@ -1384,6 +1466,8 @@ const install = async ({ dryRun, rest }) => {
   process.stdout.write(`Plugin path: ${intendedPluginPath(home)}\n`);
   process.stdout.write(hudManaged ? `HUD: LitClaude statusLine installed (${hudAccent})\n` : "HUD: user statusLine setting preserved\n");
   process.stdout.write(`Global Claude settings permissions.allow/deny: ${permissionMode} — ${permissionProfile(permissionMode).description}\n`);
+  process.stdout.write(`MOD_OPTIONS: ${modOptionsLine(readClaudeSettings(home))} (change: litclaude-ai config <option> <value>)\n`);
+  process.stdout.write("DESKTOP_APP: ready — the Claude desktop app's Code tab reads these same settings; open a new session there\n");
   process.stdout.write(`${prewarmMotionRuntime()}\n`);
   if (wantsIconFont) await runIconFontInstall();
   process.stdout.write("Launch with: claude\n");
@@ -1505,6 +1589,7 @@ const doctor = ({ dryRun }) => {
   process.stdout.write(`${jevStatusLine(process.env)}\n`);
   writeAutoHandoffDoctorLines();
   process.stdout.write(`${iconFontDoctorLine()}\n`);
+  process.stdout.write(`MOD_OPTIONS: ${modOptionsLine(readClaudeSettings())}\n`);
 
   // lit-typographic-motion: the five readiness probes, every run. Read-only and never fatal; a
   // missing pre-warm names the command that fixes it.
@@ -1635,6 +1720,7 @@ const uninstall = ({ dryRun }) => {
   uninstallHudStatusLine();
   uninstallOutputStyle();
   uninstallPermissionRules();
+  uninstallModOptions();
   rmSync(claudePluginRoot(), { recursive: true, force: true });
   removeEmptyDirectory(dirname(claudePluginRoot()));
   removeEmptyDirectory(pluginCacheRoot);
@@ -1730,6 +1816,9 @@ const main = async () => {
     case "doctor":
       doctor(parsed);
       break;
+    case "config":
+      configModOptions(parsed.rest);
+      break;
     case "path":
       printPath(parsed);
       break;

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.24"><title>release: 1.0.24</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.24</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.25"><title>release: 1.0.25</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.25</text></g></svg>

package/docs/hooks.md

@@ -355,7 +355,7 @@ status line read as one family:
 ╭─ [🔥 LIT] · lit-loop ─────────────────────────── WORK ● ─╮
 │ ● PLAN ━━ [WORK] ━━ ○ REVIEW              goal ██░░░ 2/5 │
 │ skills [⚡ lit-plan] [⚡ litresearch] [↯ lit-docx]        │
-╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · git main ──────────────────────╯
+╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · 1w 12% · git main ─────────────╯
 ```
 
 The brackets stand for the ends of filled pills: rounded caps from the icon font with `nerd`
@@ -380,7 +380,7 @@ requests are muted grey pills.
   With no chip yet, the row shows the next task while work runs, or how to start (`lit <task>`)
   while idle.
 - The bottom edge carries the live figures from the status line: context fill, the five-hour
-  rate window and the Git branch (read from `HEAD`, across a linked worktree).
+  and weekly rate windows and the Git branch (read from `HEAD`, across a linked worktree).
 - A notice takes the chips row for a few seconds, with a toast, when a gate fires: lit-plan not
   saved, interface probe pending or failed, motion gate, context near the auto-handoff percent,
   auto-handoff fired. The completion moment takes it when the last task is checked, the work
@@ -397,9 +397,9 @@ chips of the current request stay bright until the main turn completes. An agent
 as ended stops counting at once, and one quiet for 30 minutes (no tool call, no status change)
 stops counting too, so a crashed or lost agent cannot hold the card at work.
 
-The card is the terminal's width up to 80 columns and every row is fitted to it, with Hangul and
+The card is the terminal's width up to 120 columns and every row is fitted to it, with Hangul and
 emoji counted as two cells. Nothing wraps: on a narrow terminal the Git branch goes first, then
-the rate window, the lanes, the autoloop count and the long phase labels (`P ━ W ━ R`).
+the weekly and five-hour windows, the lanes, the autoloop count and the long phase labels (`P ━ W ━ R`).
 
 The spinner gains ` · <discipline> · n/m` after its ellipsis. `/lit-evidence` opens a pane with
 three tabs (keys `1`, `2`, `3`): the goal's criteria with their last evidence, blockers and the
@@ -408,17 +408,26 @@ newest litgoal ledger entries; the lanes; and the gates.
 Motion: entrances pop in 60 ms apart with a slight overshoot (160 ms each), fills and colour
 changes ease in and out (300 ms and 140 ms), notices slide in over 220 ms and leave over 150 ms,
 a chip's arrival light runs 400 ms (a plain fade under `subtle`, nothing under `off`), and the
-finish lasts at most 1.2 s. The band's `Client` element animates on Claude Code's frame
-clock only while something moves and stops its timer as soon as everything settles. In Claude
+finish lasts at most 1.2 s. While LitClaude is at work the card keeps moving so you can tell it
+is active at a glance: the LIT pill breathes from pink to flame orange every 2.4 s, a light sweeps
+across the active phase and this request's skill chips every 1.8 s, and a comet runs along the top rule and back along the
+bottom one every 2.6 s. Under `subtle` only the breathing stays; under `off` nothing moves. An
+idle card holds still. The band's `Client` element animates on Claude Code's frame clock, every
+33 ms while a transition plays and every 66 ms during work, and stops its timer once the card is
+idle and settled. In Claude
 Code 2.1.292 a terminal row whose only change is a non-ASCII glyph is not repainted, so every
 moving part changes ASCII text or colour: bar cells are coloured spaces, embers are ASCII sparks,
 a chip's light moves over its ASCII name, and a glyph swaps only together with its words.
 
-Options, in `/config` under LitClaude (stored in `pluginConfigs`):
+Options, in `/config` under LitClaude (stored in `pluginConfigs` in `~/.claude/settings.json`,
+which the terminal and the desktop app's Code tab both read). The installer writes each default
+you have not set, so the desktop app, which has no editor for them, starts with all three;
+`litclaude-ai config` prints them and `litclaude-ai config <option> <value>` changes one.
+Uninstall removes only the defaults it wrote that are still unchanged.
 
 | Option | Values | Default |
 | --- | --- | --- |
-| `motion` | `full`, `subtle` (no overshoot, shimmer or embers, shorter), `off` (final frames only) | `full` |
+| `motion` | `full`, `subtle` (no overshoot, shimmer, embers, sweep or comet, shorter; the LIT pill still breathes during work), `off` (final frames only) | `full` |
 | `glyphs` | `auto` (Nerd glyphs when the icon font is installed), `nerd`, or `basic` | `auto` |
 | `band` | `always` (the whole session, idle included), `auto` (only while work is active or a skill of this request is lit), `off` | `always` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litclaude",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "Claude Code plugin: add lit to a prompt and Claude plans, tests, checks and reviews the work, then leaves a handoff for the next session.",
   "type": "module",
   "bin": {

package/plugins/litclaude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "litclaude",
   "description": "Claude Code-native workflow plugin with a bounded-authority start-work lifecycle.",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "author": {
     "name": "LitClaude contributors"
   },
@@ -18,7 +18,7 @@
     "motion": {
       "type": "string",
       "title": "LIT band motion",
-      "description": "How the band above the prompt moves: full, subtle (no overshoot, shimmer or embers) or off.",
+      "description": "How the band above the prompt moves: full (during work the LIT pill breathes, a light sweeps the phase and a comet runs the border), subtle (only the breathing) or off.",
       "default": "full"
     },
     "glyphs": {

package/plugins/litclaude/bin/litclaude-mcp.js

@@ -9,7 +9,7 @@ import {
 } from "../lib/wikify-knowledge.mjs";
 
 const protocolVersion = "2024-11-05";
-const serverVersion = "1.0.24";
+const serverVersion = "1.0.25";
 
 const publicSourceReadTool = {
   name: "public_source_read",

package/plugins/litclaude/hooks/lit-band-client.mjs

@@ -1,12 +1,13 @@
 // The LIT band's surface module: the `Client` element lit-mod.mjs draws above the prompt. It runs on
 // the drawing thread with no mods API, keeps the band's timeline in its local state, and animates on
-// the surface's own frame clock only while something moves; once the timeline settles it stops its
-// timer and the band stays still until the hooks module hands it a new model.
+// the surface's own frame clock: fast while a transition plays, slower while the ambient loop says
+// LitClaude is at work, and not at all once the card is idle and settled, when it stays still until
+// the hooks module hands it a new model.
 
 import { composeBand } from "../lib/mod/frame.mjs";
 import { TIMINGS, motionProfile } from "../lib/mod/motion.mjs";
 import { renderBand } from "../lib/mod/render.mjs";
-import { advanceTimeline, createTimeline, sampleTimeline, timelineBusy } from "../lib/mod/timeline.mjs";
+import { advanceTimeline, ambientActive, createTimeline, sampleTimeline, timelineBusy } from "../lib/mod/timeline.mjs";
 
 // The timeline lives in one holder object that the frame timer and every draw share. The timer
 // never reads `surface.state` back, so a draw that folded in a new model is never overwritten by a
@@ -17,7 +18,7 @@ export default function LitBand(props, surface) {
   const empty = () => surface.elements.Box({ children: [] });
   if (!model) return empty();
 
-  const holder = surface.state?.live ?? { now: 0, model: null, timeline: null, stop: null };
+  const holder = surface.state?.live ?? { now: 0, model: null, timeline: null, stop: null, interval: null };
   if (holder.timeline === null) {
     holder.timeline = createTimeline(model, 0, profile);
     holder.model = model;
@@ -26,19 +27,25 @@ export default function LitBand(props, surface) {
     holder.model = model;
   }
 
-  if (holder.stop === null && timelineBusy(holder.timeline, holder.now, profile)) {
-    holder.stop = surface.every(TIMINGS.frame, () => {
-      holder.now += TIMINGS.frame;
-      if (!timelineBusy(holder.timeline, holder.now, profile)) {
-        holder.stop?.();
-        holder.stop = null;
-      }
+  const interval = () => (timelineBusy(holder.timeline, holder.now, profile) ? TIMINGS.frame
+    : ambientActive(holder.timeline, profile) ? TIMINGS.ambientFrame : null);
+  const schedule = () => {
+    const wanted = interval();
+    if (wanted === holder.interval) return;
+    holder.stop?.();
+    holder.stop = null;
+    holder.interval = wanted;
+    if (wanted === null) return;
+    holder.stop = surface.every(wanted, () => {
+      holder.now += wanted;
+      schedule();
       surface.setState({ live: holder, now: holder.now });
     });
-  }
+  };
+  schedule();
   if (surface.state?.live !== holder) surface.setState({ live: holder, now: holder.now });
 
-  if (!model.visible && !timelineBusy(holder.timeline, holder.now, profile)) return empty();
+  if (!model.visible && interval() === null) return empty();
   const frame = composeBand(model, sampleTimeline(holder.timeline, holder.now, profile), { columns: props.columns, glyphs: props.glyphs, accent: props.accent });
   return renderBand(surface.elements, frame);
 }

package/plugins/litclaude/lib/mod/frame.mjs

@@ -7,7 +7,7 @@
 //   ╭─ [🔥 LIT] · lit-loop ─────────────────────────── WORK ● ─╮
 //   │ ● PLAN ━━ [WORK] ━━ ○ REVIEW              goal ██░░░ 2/5 │
 //   │ skills [⚡ lit-plan] [⚡ litresearch] [↯ lit-docx]        │
-//   ╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · git main ──────────────────────╯
+//   ╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · 1w 12% · git main ─────────────╯
 //
 // Each bracket pair stands for the two end cells of a filled pill: the brand on pink, the active
 // phase and this request's skills on the accent with dark text, skills from earlier requests on
@@ -44,7 +44,7 @@ export const PALETTE = Object.freeze({
 // The status line's level colours (xterm 71, 178, 167) and its empty bar cells (238).
 const HUD = Object.freeze({ green: "#5faf5f", yellow: "#d7af00", red: "#d75f5f", empty: "#444444" });
 // Past this many columns the card stops growing, so a wide terminal does not stretch it thin.
-export const CARD_MAX = 80;
+export const CARD_MAX = 120;
 // Pill colours: dark text on the bright fills, the muted pill for earlier skills and +N, the brand
 // pink of the status line's prefix, and the connectors between phases.
 const PILL = Object.freeze({ ink: "#0b0f14", muted: "#2d333b", mutedText: "#adb5bf", brand: PALETTE.pink, rail: "#46505c" });
@@ -145,18 +145,52 @@ const fitJoined = (segments, room) => {
 
 const joinSegments = (kept, joinerColor) => kept.flatMap((part, index) => (index > 0 ? [span(part.joiner, { fg: joinerColor }), ...part.spans] : part.spans));
 
+const COMET_TAIL = 12;
+
+// The comet's colour `k` of the way from its tail (0) to its head (1): flame orange fading in, pink
+// through the body and white at the head, laid over the rule's own colour.
+const cometColor = (base, k) => {
+  const hue = k > 0.8 ? lerpColor(PALETTE.pink, "#ffffff", (k - 0.8) / 0.2) : lerpColor(PALETTE.orange, PALETTE.pink, k / 0.8);
+  return lerpColor(base, hue, Math.min(1, k * 1.6));
+};
+
+// The rule of an edge, `count` cells from column `start`. With a comet ({ x, dir }: its head's
+// column and travel direction) the cells behind the head light up, brightest at the head, and the
+// rule becomes one span per cell; without one it stays a single span.
+const ruleSpans = (count, color, start, comet) => {
+  if (!comet) return [span("─".repeat(count), { fg: color })];
+  return Array.from({ length: count }, (_, i) => {
+    const behind = comet.dir * (comet.x - (start + i));
+    const k = behind >= 0 && behind <= COMET_TAIL ? 1 - behind / COMET_TAIL : 0;
+    return span("─", { fg: k > 0 ? cometColor(color, k) : color });
+  });
+};
+
 // An edge of the card: `open` and `close` are its corners, `left` its title or figures and
 // `right` the phase indicator, with the rule filling whatever room is left.
-const edgeRow = (open, left, right, close, width, color) => {
+const edgeRow = (open, left, right, close, width, color, comet = null) => {
   const tail = right.length ? [span(" "), ...right, span(` ${close}`, { fg: color })] : [span(close, { fg: color })];
   const fill = Math.max(1, width - textWidth(open) - rowWidth(left) - 1 - rowWidth(tail));
-  return clipRow([span(open, { fg: color }), ...left, span(" "), span("─".repeat(fill), { fg: color }), ...tail], width);
+  const start = textWidth(open) + rowWidth(left) + 1;
+  return clipRow([span(open, { fg: color }), ...left, span(" "), ...ruleSpans(fill, color, start, comet), ...tail], width);
+};
+
+// Where the ambient comet is on this card: along the top rule left to right for the first half of
+// its loop, then back along the bottom rule, starting and ending just off the card.
+const cometOn = (sample, edge, width) => {
+  const u = sample.ambient?.comet;
+  if (u === null || u === undefined) return null;
+  const span = width + 2 * COMET_TAIL;
+  if (edge === "top") return u < 0.5 ? { x: u * 2 * span - COMET_TAIL, dir: 1 } : null;
+  return u >= 0.5 ? { x: width + COMET_TAIL - (u - 0.5) * 2 * span, dir: -1 } : null;
 };
 
+// While LitClaude works the brand pill breathes from its pink toward the flame orange and back.
 const brandSpans = (sample, glyphs) => {
   const reveal = revealText("🔥 LIT", sample.pills[0]);
   if (reveal === null) return [];
-  return pill(litText(reveal, { fg: PILL.ink, bg: PILL.brand, bold: true }, sample.completion?.shimmer ?? null), PILL.brand, glyphs);
+  const fill = sample.ambient ? lerpColor(PILL.brand, PALETTE.orange, 0.85 * sample.ambient.breath) : PILL.brand;
+  return pill(litText(reveal, { fg: PILL.ink, bg: fill, bold: true }, sample.completion?.shimmer ?? null), fill, glyphs);
 };
 const indicatorSpans = (model, sample, glyphs, accent) => {
   if (sample.completion) return [span(`DONE ${glyphs.done}`, { fg: PALETTE.green, bold: true })];
@@ -177,10 +211,11 @@ const topEdge = (model, sample, { width, glyphs, accent, edge }) => {
   const title = (text) => (text ? [span(" · ", { fg: PALETTE.dim }), span(text, nameStyle)] : []);
   const fixed = textWidth("╭─ ") + rowWidth(brand) + 1 + 1;
   const withRight = fixed + rowWidth(title(name)) + 1 + rowWidth(right) + textWidth(" ─╮");
-  if (withRight <= width) return edgeRow("╭─ ", [...brand, ...title(name)], right, "─╮", width, edge);
+  const comet = cometOn(sample, "top", width);
+  if (withRight <= width) return edgeRow("╭─ ", [...brand, ...title(name)], right, "─╮", width, edge, comet);
   const room = width - fixed - textWidth("─╮") - textWidth(" · ");
   const shown = room >= 4 ? truncateToWidth(name, room) : "";
-  return edgeRow("╭─ ", [...brand, ...title(shown)], [], "─╮", width, edge);
+  return edgeRow("╭─ ", [...brand, ...title(shown)], [], "─╮", width, edge, comet);
 };
 
 const barSpans = (fraction, sample, cells) => barCells(fraction, cells, sample.fillGlow ?? 0)
@@ -223,7 +258,8 @@ const phaseTrack = (model, sample, { glyphs, accent, rail, short }) => {
     if (out.length) out.push(span(` ${glyphs.rail.repeat(rail)} `, { fg: sample.phases[PHASES[index - 1]].to === "done" ? ink.done : PILL.rail }));
     if (state === "now") {
       const fill = model.idle ? lerpColor(phaseColor(id, sample, ink), PILL.muted, 0.5) : phaseColor(id, sample, ink);
-      out.push(...pill([span(shown.slice(0, label.length).padEnd(label.length), { fg: PILL.ink, bg: fill, bold: true })], fill, glyphs));
+      const sweep = model.idle ? null : sample.ambient?.sweep ?? null;
+      out.push(...pill(litText(shown.slice(0, label.length).padEnd(label.length), { fg: PILL.ink, bg: fill, bold: true }, sweep), fill, glyphs));
     } else {
       out.push(span(warned(id, sample) ? shown.replace(/^[●○]/u, glyphs.warn) : shown, { fg: phaseColor(id, sample, ink) }));
     }
@@ -264,7 +300,7 @@ const CHIP_TONE = Object.freeze({
 // One chip pill: the bolt and the skill name, on the accent for this request or muted for an
 // earlier one. A chip that just arrived carries full motion's light along its name, or fills up
 // from the muted pill under subtle; a chip changing state crossfades its colours.
-const chipSpans = (chip, timed, glyphs, accent) => {
+const chipSpans = (chip, timed, glyphs, accent, sweep = null) => {
   const to = timed?.to ?? chip.state;
   const from = timed?.from ?? to;
   const mix = timed?.mix ?? 1;
@@ -275,7 +311,7 @@ const chipSpans = (chip, timed, glyphs, accent) => {
   const bold = to === "current";
   return pill([
     span(`${to === "current" ? glyphs.bolt : glyphs.recentBolt} `, { fg: text, bg: fill }),
-    ...litText(chip.id, { fg: text, bg: fill, bold }, timed?.shimmer),
+    ...litText(chip.id, { fg: text, bg: fill, bold }, timed?.shimmer ?? (to === "current" && arrive >= 1 ? sweep : null)),
   ], fill, glyphs);
 };
 
@@ -296,7 +332,8 @@ const chipsRow = (model, sample, { inner, glyphs, accent }) => {
   const row = inner >= 30 ? [span("skills", { fg: PALETTE.dim })] : [];
   let shown = 0;
   for (const chip of chips) {
-    const entry = chipSpans(chip, sample.chips?.[chip.id], glyphs, accent);
+    // While LitClaude works the light that crosses the active phase crosses this request's chips too.
+    const entry = chipSpans(chip, sample.chips?.[chip.id], glyphs, accent, model.idle ? null : sample.ambient?.sweep ?? null);
     const gap = row.length ? [span(" ")] : [];
     const rest = chips.length - shown - 1;
     const reserve = rest > 0 ? 1 + rowWidth(mutedPill(`+${rest}`, glyphs)) : 0;
@@ -346,10 +383,10 @@ const completionRow = (sample, inner) => {
 
 const levelColor = (percent) => (percent >= 90 ? HUD.red : percent >= 70 ? HUD.yellow : HUD.green);
 
-// ╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · git main ───╯, or a warning first when one is up. The branch goes
-// first on a narrow card, then the rate window, then the context bar.
-const bottomEdge = (model, { width, glyphs, accent, edge }) => {
-  const { context, rate, git } = model.figures;
+// ╰─ ctx 42% ▰▰▱▱▱ · 5h 31% · 1w 12% · git main ───╯, or a warning first when one is up. The branch goes
+// first on a narrow card, then the weekly window, the five-hour one and the context bar.
+const bottomEdge = (model, sample, { width, glyphs, accent, edge }) => {
+  const { context, rates, git } = model.figures;
   const warning = model.warnings[0];
   const segments = [];
   if (warning) {
@@ -361,19 +398,21 @@ const bottomEdge = (model, { width, glyphs, accent, edge }) => {
     const filled = Math.max(0, Math.min(5, Math.round(context / 20)));
     segments.push(segment("ctxbar", 2, [span("▰".repeat(filled), { fg: accent }), span("▱".repeat(5 - filled), { fg: HUD.empty })], " "));
   }
-  if (rate) segments.push(segment("rate", 3, [span(`${rate.label} `, { fg: PALETTE.dim }), span(`${rate.percent}%`, { fg: levelColor(rate.percent) })], " · "));
+  rates.forEach((rate, index) => segments.push(segment(`rate-${rate.label}`, 3 + index * 0.5, [span(`${rate.label} `, { fg: PALETTE.dim }), span(`${rate.percent}%`, { fg: levelColor(rate.percent) })], " · ")));
   if (git) segments.push(segment("git", 4, [span(`${glyphs.branch} `, { fg: PALETTE.dim }), span(git, { fg: accent })], " · "));
   const room = width - textWidth("╰─ ") - 1 - 1 - textWidth("─╯");
   let kept = fitJoined(segments, room);
   if (kept[0]?.id === "ctxbar") kept = kept.slice(1);
   if (kept.length === 0 && warning) kept = [{ ...segments[0], spans: clipRow(segments[0].spans, room) }];
-  return edgeRow("╰─ ", joinSegments(kept, edge), [], "─╯", width, edge);
+  return edgeRow("╰─ ", joinSegments(kept, edge), [], "─╯", width, edge, cometOn(sample, "bottom", width));
 };
 
-const edgeColor = (model, accent) => {
+// The border: red or amber under a warning, otherwise the accent, dimmer while idle and breathing
+// toward full accent with the brand pill while LitClaude works.
+const edgeColor = (model, sample, accent) => {
   if (model.warnings.some(({ tone }) => tone === "red")) return PALETTE.red;
   if (model.warnings.length) return PALETTE.amber;
-  return lerpColor(PALETTE.faint, accent, model.idle ? 0.35 : 0.6);
+  return lerpColor(PALETTE.faint, accent, model.idle ? 0.35 : 0.6 + 0.4 * (sample.ambient?.breath ?? 0));
 };
 
 /**
@@ -385,7 +424,7 @@ export const composeBand = (model, sample, { columns, glyphs: glyphMode = "basic
   const glyphs = glyphSet(glyphMode);
   const width = Math.max(12, Math.min(CARD_MAX, columns));
   const inner = width - 4;
-  const edge = edgeColor(model, accent);
+  const edge = edgeColor(model, sample, accent);
   const side = (row) => [span("│ ", { fg: edge }), ...row, span(" │", { fg: edge })];
   const options = { width, inner, glyphs, accent, edge };
   const middle = sample.completion ? completionRow(sample, inner) : sample.notice ? noticeRow(sample, inner) : chipsRow(model, sample, options);
@@ -393,7 +432,7 @@ export const composeBand = (model, sample, { columns, glyphs: glyphMode = "basic
     mode: "card",
     border: edge,
     width,
-    rows: [topEdge(model, sample, options), side(phaseRow(model, sample, options)), side(middle), bottomEdge(model, options)],
+    rows: [topEdge(model, sample, options), side(phaseRow(model, sample, options)), side(middle), bottomEdge(model, sample, options)],
   };
 };
 

package/plugins/litclaude/lib/mod/motion.mjs

@@ -27,18 +27,24 @@ export const TIMINGS = Object.freeze({
   completion: 1200,
   exit: 150,
   frame: 33,
+  breath: 2400,
+  sweep: 1800,
+  comet: 2600,
+  ambientFrame: 66,
 });
 
-// full: the approved motion. subtle: no overshoot, no shimmer or embers, three quarters the time.
-// off: every duration is zero, so the band draws its final frame and never starts a frame timer.
+// full: the approved motion, and while LitClaude works the brand breathes, a light sweeps the active
+// phase and a comet runs around the card's rules. subtle: no overshoot, no shimmer or embers, three
+// quarters the time, and only the breathing while working. off: every duration is zero, so the band
+// draws its final frame and never starts a frame timer.
 export const motionProfile = (mode) => {
   if (mode === "off") {
-    return { mode, duration: () => 0, enterEase: EASE.linear, noticeEase: EASE.linear, shimmer: false, embers: false };
+    return { mode, duration: () => 0, enterEase: EASE.linear, noticeEase: EASE.linear, shimmer: false, embers: false, ambient: null };
   }
   if (mode === "subtle") {
-    return { mode, duration: (ms) => Math.round(ms * 0.75), enterEase: EASE.outCubic, noticeEase: EASE.outCubic, shimmer: false, embers: false };
+    return { mode, duration: (ms) => Math.round(ms * 0.75), enterEase: EASE.outCubic, noticeEase: EASE.outCubic, shimmer: false, embers: false, ambient: { sweep: false, comet: false } };
   }
-  return { mode: "full", duration: (ms) => ms, enterEase: EASE.outBack, noticeEase: EASE.outBack, shimmer: true, embers: true };
+  return { mode: "full", duration: (ms) => ms, enterEase: EASE.outBack, noticeEase: EASE.outBack, shimmer: true, embers: true, ambient: { sweep: true, comet: true } };
 };
 
 export const clamp01 = (x) => (x <= 0 ? 0 : x >= 1 ? 1 : x);

package/plugins/litclaude/lib/mod/settings.mjs

@@ -3,7 +3,7 @@
 // one; the values are checked here instead, and anything unknown falls back to the default (the
 // first choice).
 
-const CHOICES = Object.freeze({
+export const MOD_CHOICES = Object.freeze({
   motion: ["full", "subtle", "off"],
   glyphs: ["auto", "nerd", "basic"],
   band: ["always", "auto", "off"],
@@ -15,9 +15,9 @@ const pick = (value, choices) => {
 };
 
 export const normalizeModSettings = (options) => ({
-  motion: pick(options?.motion, CHOICES.motion),
-  glyphs: pick(options?.glyphs, CHOICES.glyphs),
-  band: pick(options?.band, CHOICES.band),
+  motion: pick(options?.motion, MOD_CHOICES.motion),
+  glyphs: pick(options?.glyphs, MOD_CHOICES.glyphs),
+  band: pick(options?.band, MOD_CHOICES.band),
 });
 
 // The glyph set one surface draws. Private-use Nerd Font glyphs only reach the terminal, which

package/plugins/litclaude/lib/mod/timeline.mjs

@@ -22,9 +22,17 @@ const chipsOf = (model, now, previous = null) => Object.fromEntries((model.skill
   return [chip.id, known];
 }));
 
+// The ambient loop runs while the card shows LitClaude at work, so motion itself says "active";
+// `at` is when the current run of work began, so the loop does not restart on every new model.
+const ambientOf = (model, now, profile, previous = null) => {
+  const on = Boolean(profile.ambient) && model.visible && !model.idle;
+  return { on, at: on && previous?.on ? previous.at : now };
+};
+
 export const createTimeline = (model, now, profile) => {
   const restAt = now + entryEnd(profile);
   return {
+    ambient: ambientOf(model, now, profile),
     enterAt: now,
     exitAt: null,
     fill: { from: 0, to: fractionOf(model), at: restAt, dur: profile.duration(TIMINGS.fill) },
@@ -63,9 +71,28 @@ export const advanceTimeline = (timeline, model, now, profile) => {
     next.completion = model.completion ? { data: model.completion, at: now } : null;
   }
   next.chips = chipsOf(model, now, timeline.chips);
+  next.ambient = ambientOf(model, now, profile, timeline.ambient);
   return next;
 };
 
+/** True while the ambient loop runs; the surface module then keeps a slower frame timer going. */
+export const ambientActive = (timeline, profile) => Boolean(profile.ambient) && timeline.exitAt === null && timeline.ambient.on;
+
+// One frame of the ambient loop: `breath` (0 to 1 and back over TIMINGS.breath), where the light
+// stands on the active phase (`sweep`, null between passes) and how far the comet has gone around
+// the card (`comet`, 0 to 1: the top rule left to right, then the bottom rule right to left).
+const ambientSample = (timeline, now, profile) => {
+  if (!ambientActive(timeline, profile)) return null;
+  const elapsed = Math.max(0, now - timeline.ambient.at);
+  const breath = 0.5 - 0.5 * Math.cos((2 * Math.PI * elapsed) / TIMINGS.breath);
+  const pass = ((elapsed % TIMINGS.sweep) / TIMINGS.sweep) * 1.6 - 0.3;
+  return {
+    breath,
+    sweep: profile.ambient.sweep && pass >= -0.2 && pass <= 1.2 ? pass : null,
+    comet: profile.ambient.comet ? (elapsed % TIMINGS.comet) / TIMINGS.comet : null,
+  };
+};
+
 export const timelineBusy = (timeline, now, profile) => {
   const d = profile.duration;
   if (timeline.exitAt !== null) return now < timeline.exitAt + d(TIMINGS.exit);
@@ -142,6 +169,7 @@ export const sampleTimeline = (timeline, now, profile) => {
     notice,
     completion,
     chips,
+    ambient: ambientSample(timeline, now, profile),
   };
 };
 

package/plugins/litclaude/lib/mod/view.mjs

@@ -137,14 +137,16 @@ const goalSummaryOf = (goal) => {
   return { status: goal.status, passed: goal.criteria.filter(({ status }) => status === "pass").length, total: goal.criteria.length };
 };
 
-// The bottom edge's live figures, as the status line shows them: context fill, the five-hour
-// window (the weekly one when that is all there is) and the Git branch.
+// The bottom edge's live figures, as the status line shows them: context fill, the five-hour and
+// weekly windows and the Git branch.
 const figuresOf = (usage, git) => {
   const context = Number.isFinite(usage?.context?.percent) ? Math.round(usage.context.percent) : null;
   const windows = Array.isArray(usage?.rateLimits) ? usage.rateLimits : [];
-  const window = windows.find(({ kind }) => kind === "five_hour") ?? windows.find(({ kind }) => kind === "seven_day") ?? null;
-  const rate = window && Number.isFinite(window.percentUsed) ? { label: window.kind === "five_hour" ? "5h" : "1w", percent: Math.round(window.percentUsed) } : null;
-  return { context, rate, git: typeof git === "string" && git ? git : null };
+  const rates = [["five_hour", "5h"], ["seven_day", "1w"]].flatMap(([kind, label]) => {
+    const window = windows.find((entry) => entry.kind === kind);
+    return window && Number.isFinite(window.percentUsed) ? [{ label, percent: Math.round(window.percentUsed) }] : [];
+  });
+  return { context, rates, git: typeof git === "string" && git ? git : null };
 };
 
 /**