@litfamily/litclaude 1.0.23 → 1.0.25

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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.
+- The README shows the LIT card as it really appears: resting before anything runs, at work with the skill's chip lit, and after the turn, when the chip dims into the recent list.
+- The README walks through automatic handoff with terminal pictures: turning it on with `lit-handoff auto on 65`, checking and turning it off, the reminder to run `/compact`, and the two shell variables that switch it on before Claude Code starts.
+- The install section has a prompt you can paste into a coding agent so it installs LitClaude for you. The agent shows what would change and waits for your yes, runs the doctor, and reminds you to restart Claude Code.
+- The office runtime now pins sharp 0.35.5, and the README Studio cover templates use sharp 0.35.5 and source-map-js 1.2.2.
+
 ## 1.0.23 - 2026-10-12
 
 - The LIT card above the prompt now stays on screen for the whole session, so you can still see the status after the work ends. It is a small four-row card in the colours of your status line. The top edge names the workflow and the current phase. Below it are the plan, work and review steps with the progress of the plan or goal. Every LitClaude skill that runs gets its own chip, several at once. A chip is bright while its request is running and dims into a recent list when the turn ends. At the bottom are the context use, the five-hour usage window and the Git branch. The card fits narrow terminals by leaving out the least important parts and never wraps. The `band` setting now defaults to `always`; `auto` brings back the old behaviour, and `off` hides the card.

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.23/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23/docs/assets/readme/badge-version.svg" alt="1.0.23" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23/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.23/docs/privacy.md)
-- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/CHANGELOG.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23/docs/assets/readme/badge-version.svg" alt="1.0.23" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23/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.23/docs/privacy.md)
-- [이전과 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/docs/migration.md)
-- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/CHANGELOG.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.23/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.23"><title>release: 1.0.23</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.23</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`
@@ -365,10 +365,11 @@ requests are muted grey pills.
 
 - The top edge names the discipline the prompt hook ignited (the last one, dimmed, while the
   session is idle; `ready` before any) and, on the right, the current phase: `WORK ●`, `idle`,
-  or `DONE ✓` during the finish.
+  or `DONE ✓` during the finish. While a subagent is still running the card stays at work
+  (`LIVE ●` when no phase is active) and never reads `DONE`, even after the main turn ended.
 - The phase row lights `PLAN ━━ WORK ━━ REVIEW` from the start-work plan, the litgoal goal and
   the discipline (the active phase as a pill, done phases `●`, the rest `○`), and on its right shows a pink-to-cyan progress bar with the checked tasks or
-  passed criteria (`goal ✓ 5/5` once a goal is met), the number of live subagents, the autoloop
+  passed criteria (`goal ✓ 5/5` once a goal is met), the number of live subagents (`● 2 lanes`), the autoloop
   count with the time left in its 30-minute budget, and `ctx 76% → 80%` when the context is
   within five points of the auto-handoff percent.
 - The chips row shows each LitFamily skill that fired as a pill: a Skill tool call naming a LitClaude
@@ -379,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
@@ -389,9 +390,16 @@ requests are muted grey pills.
   border amber and puts `⚠ <lane> quiet for 12m` on the bottom edge; a failed interface probe
   turns it red.
 
-The card is the terminal's width up to 80 columns and every row is fitted to it, with Hangul and
+Subagents and teammates come from Claude Code's agent list. A workflow script's agents never
+appear there, so the mod also records every agent at `agent.spawn` and counts it until that
+agent's own `turn.complete` arrives. A subagent's turn ending does not end the main turn: the
+chips of the current request stay bright until the main turn completes. An agent the list shows
+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 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
@@ -400,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.23",
+  "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.23",
+  "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.23";
+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/hooks/lit-mod.mjs

@@ -22,7 +22,11 @@ import {
   buildEvidenceModel,
   detectCompletion,
   diffNotices,
+  mergeSpawned,
   noteAgentActivity,
+  noteSpawn,
+  noteSpawnActivity,
+  noteSpawnEnded,
   spinnerSuffix,
   trackAgents,
 } from "../lib/mod/view.mjs";
@@ -44,6 +48,7 @@ const createLive = (options) => ({
   snapshot: null,
   model: null,
   agents: [],
+  spawned: {},
   usage: null,
   activity: EMPTY_ACTIVITY,
   statusById: {},
@@ -150,9 +155,10 @@ async function refresh($, live) {
     const [cwd, sessionId] = await Promise.all([$.session.cwd(), $.session.id()]);
     const fresh = await readLitSnapshot(stateIo($), { cwd, sessionId, env: live.env });
     live.git = await readGitBranch(stateIo($), cwd).catch(() => live.git);
-    live.agents = await $.agent.list().catch(() => []);
+    const listed = await $.agent.list().catch(() => []);
     live.usage = await $.session.usage().catch(() => live.usage);
     const now = await $.clock.now();
+    ({ agents: live.agents, spawned: live.spawned } = mergeSpawned(listed, live.spawned, now));
     live.activity = trackAgents(live.activity, live.agents, live.statusById, now);
     live.statusById = Object.fromEntries(live.agents.map((agent) => [agent.id, agent.status]));
     const before = live.snapshot;
@@ -217,6 +223,12 @@ export const register = (on, options) => {
   });
 
   on("turn.complete", async ($, e, next) => {
+    // A subagent's or teammate's turn ends its run, not the main turn the card follows.
+    if (typeof e.agentId === "string") {
+      live.spawned = noteSpawnEnded(live.spawned, e.agentId);
+      refreshSoon($, live);
+      return next(e);
+    }
     live.isWorking = false;
     // The request is over: its chips dim to the recent list until a skill fires again.
     live.settledAt = await $.clock.now();
@@ -232,12 +244,28 @@ export const register = (on, options) => {
 
   on("tool.call", async ($, e, next) => {
     if (e.tool === "Skill") await noteFiring($, live, e.skill);
+    if (typeof e.agentId === "string") live.spawned = noteSpawnActivity(live.spawned, e.agentId, await $.clock.now());
     const result = await next(e);
-    if (typeof e.agentId === "string") live.activity = noteAgentActivity(live.activity, e.agentId, await $.clock.now());
+    if (typeof e.agentId === "string") {
+      const now = await $.clock.now();
+      live.activity = noteAgentActivity(live.activity, e.agentId, now);
+      live.spawned = noteSpawnActivity(live.spawned, e.agentId, now);
+    }
     refreshSoon($, live);
     return result;
   }).catch(($, e, next) => next(e));
 
+  // Every subagent, teammate and workflow agent starts here. A workflow's never shows in
+  // `$.agent.list()`, so the card keeps its own record until the agent's turn.complete.
+  on("agent.spawn", async ($, e, next) => {
+    const result = await next(e);
+    if (typeof result?.agentId === "string") {
+      live.spawned = noteSpawn(live.spawned, { id: result.agentId, description: e.description, type: e.subagentType, at: await $.clock.now() });
+      refreshSoon($, live);
+    }
+    return result;
+  }).catch(($, e, next) => next(e));
+
   // A typed `/litclaude:<name>` and the Skill tool both expand the skill's prompt here; the text
   // passes through untouched.
   on("skill.prompt", async ($, e, next) => {

package/plugins/litclaude/lib/canonical-skill-resources.mjs

@@ -11,8 +11,8 @@ export const canonicalSkillResourceManifest = Object.freeze(
     ["lib/durable-plan.mjs", "33fc7c2ba6305602c73650c8f29e6141e93b8ac32a444f772807e11bf8c22e44"],
     ["lib/immutable-expected-file-map.mjs", "4061486bc8eda8a53e56b7b346a1e400e7c858c0a682c83362fea460b46dfd4b"],
     ["lib/lit-mark.mjs", "cb57921a3da0ff983c74e9426dcd3b2379db090198743139e379a059c128021e"],
-    ["lib/office-runtime-lock/package-lock.json", "4b9552dba69bf2803cecdf71996d26de0497004c00d1e1f5753a5b299f85d8ba"],
-    ["lib/office-runtime-lock/package.json", "edf7fee2ba78d6ad42bf5761678b2a2210adb7282108864360f83c46adb59708"],
+    ["lib/office-runtime-lock/package-lock.json", "16d19b420b410035e9ca6886133368444a2b438121919857b3e8915be280c6a6"],
+    ["lib/office-runtime-lock/package.json", "5e4b0c7ee7bd5ff88c888f7f46152c605caf128cc4e7bfd16423571210925394"],
     ["lib/office-runtime-lock/requirements.lock", "7c63ce0de1ae9a912d1e546e9c01dd99a705d4a50435f36040d351cc3e6e6014"],
     ["lib/office-runtime.mjs", "24d108a4ae7aa98dd0d6f2fa66686d7c9f020ecf42fe641241be2869075bbea3"],
     ["lib/office_data.py", "0f4c2449622b6d59630e60508594d181279052c41918df4370e11a68df1ee239"],
@@ -848,11 +848,11 @@ export const canonicalSkillResourceManifest = Object.freeze(
     ["skills/readme-studio/templates/cover-source.json", "182051737e4cda9002360316bb2c01b500ecc20c27953a2d332d908f044f5cd7"],
     ["skills/readme-studio/templates/hyperframes-cover/index.html", "edaee52e01cc7d90524b43e3da80b4bc6514fef1d17b4317cbf15ed5e36a5c67"],
     ["skills/readme-studio/templates/hyperframes-cover/index.motion.json", "bef879ce5abe7810d73cc733ab635884ec807eccd7bc5e1c9bc9900049187249"],
-    ["skills/readme-studio/templates/hyperframes-cover/package-lock.json", "facce3fcbba7b9b5cd5b368b78192b035663a7c957f7802f97f037497dc193be"],
+    ["skills/readme-studio/templates/hyperframes-cover/package-lock.json", "5adacd09e4608c8c3917ca0245052e4d3abae3a566ebe07a2fdad593c67cb91c"],
     ["skills/readme-studio/templates/hyperframes-cover/package.json", "0993c6f04892f5a318cc99030de653b7c68d3ea6789c69b30b6a2ae80e4120f0"],
     ["skills/readme-studio/templates/readme-cover-section.md", "1dc4c536f65d3437f12e09a76170a8dc76557225587c7453631a06604a21573d"],
     ["skills/readme-studio/templates/readme-facts.json", "fb95b8aece0e8591726d3a36e25cc66712b0c6e57835c848db0f07b745e73205"],
-    ["skills/readme-studio/templates/remotion-cover/package-lock.json", "45cae4a5acee8bc98ef449a2ae91c4eae775afe7fc94769b86017bedb9301511"],
+    ["skills/readme-studio/templates/remotion-cover/package-lock.json", "422af74482c6c36e5bfaa86c2fe6a78e7ff54d27d3119f9c462685333a449857"],
     ["skills/readme-studio/templates/remotion-cover/package.json", "7921a415cf96343b46c9a2a3bea9160ecc807710fb6a34ba227704eff7d83887"],
     ["skills/readme-studio/templates/remotion-cover/src/index.tsx", "81cf3edd996a98ddca46465d4bc84ca0203ecd3bdce1736bf1dc3d9f2bc15af9"],
     ["skills/readme-studio/templates/typography/package-lock.json", "1d6dc1ae0d06d0a3a5e1b2b45bea1d40be7497f1f2fb856eefd33cc3649af5bd"],