sprag-cli 3.41.0 → 3.42.1

package/bin/cli.js

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 
 /**
- * claude-token-saver CLI (formerly claude-cache-monitor)
+ * sprag CLI (formerly claude-token-saver / claude-cache-monitor)
  *
  * Usage:
- *   npx claude-token-saver                    # default report (last 30 days)
- *   npx claude-token-saver --days 7           # last 7 days
- *   npx claude-token-saver --format json      # JSON output
- *   npx claude-token-saver --format csv       # CSV output
- *   npx claude-token-saver --project myproj   # filter by project
- *   npx claude-token-saver route-scan         # detect recurring easy work → haiku-delegation candidates
- *   npx claude-token-saver install            # set up skill/hooks/statusline; asks about harness + Korean guidance
- *   npx claude-token-saver install --yes      # take the defaults without asking (same as --no-input)
- *   npx claude-token-saver --install-hook     # install PostToolUse hook
- *   npx claude-token-saver --uninstall-hook   # remove hook
+ *   npx sprag                    # default report (last 30 days)
+ *   npx sprag --days 7           # last 7 days
+ *   npx sprag --format json      # JSON output
+ *   npx sprag --format csv       # CSV output
+ *   npx sprag --project myproj   # filter by project
+ *   npx sprag route-scan         # detect recurring easy work → haiku-delegation candidates
+ *   npx sprag install            # set up skill/hooks/statusline; asks about harness + Korean guidance
+ *   npx sprag install --yes      # take the defaults without asking (same as --no-input)
+ *   npx sprag --install-hook     # install PostToolUse hook
+ *   npx sprag --uninstall-hook   # remove hook
  *   npx claude-token-saver --hook-run         # internal: called by hook
- *   npx claude-token-saver --statusline       # one-line output for Claude Code statusline API
- *   npx claude-token-saver --statusline --verbose  # longer labels
- *   npx claude-token-saver --statusline --no-color # strip ANSI colors
- *   npx claude-token-saver --statusline --icon     # use 🧠 ⏳ 💰 icons
- *   npx claude-token-saver --statusline --no-timer # hide the TTL countdown
- *   npx claude-token-saver --statusline --single-line # legacy 1-line layout (no routing-totals headline)
- *   npx claude-token-saver --statusline --exclude-session <path>
+ *   npx sprag --statusline       # one-line output for Claude Code statusline API
+ *   npx sprag --statusline --verbose  # longer labels
+ *   npx sprag --statusline --no-color # strip ANSI colors
+ *   npx sprag --statusline --icon     # use 🧠 ⏳ 💰 icons
+ *   npx sprag --statusline --no-timer # hide the TTL countdown
+ *   npx sprag --statusline --single-line # legacy 1-line layout (no routing-totals headline)
+ *   npx sprag --statusline --exclude-session <path>
  *                                               # exclude a JSONL path from lastActivity
  *                                               # (or set CACHE_MONITOR_EXCLUDE_SESSION env var)
  */
@@ -90,32 +90,32 @@ const KNOWN_SUBCOMMANDS = new Set([
   'seed', 'litellm-budget', 'feedback',
 ]);
 
-const USAGE = `claude-token-saver — Claude Code token usage, cache health, and model routing
+const USAGE = `sprag — Claude Code token usage, cache health, and model routing
 
 Usage:
-  claude-token-saver                    default report (last 30 days)
-  claude-token-saver --days 7           last 7 days
-  claude-token-saver --format json      JSON output
-  claude-token-saver --format csv       CSV output
-  claude-token-saver --project myproj   filter by project
-  claude-token-saver route-scan         detect recurring easy work → delegation candidates
-  claude-token-saver install            set up skill/hooks/statusline
-  claude-token-saver install --yes      take the defaults without asking
-  claude-token-saver uninstall          remove everything install added
-  claude-token-saver harness check      score the harness setup in CLAUDE.md
-  claude-token-saver harness analyze    run the harness transcript analysis manually
-  claude-token-saver last               most recent warning + how to handle it
-  claude-token-saver history            recent warning transitions
-  claude-token-saver handoff            write a session handoff file
-  claude-token-saver feedback "<msg>"   file a bug report / feature request (no browser needed)
-  claude-token-saver upgrade            install the latest release
-  claude-token-saver --install-hook     install cache-monitor PostToolUse hook
-  claude-token-saver --uninstall-hook   remove that hook
-  claude-token-saver --statusline       one-line output for Claude Code statusline
+  sprag                    default report (last 30 days)
+  sprag --days 7           last 7 days
+  sprag --format json      JSON output
+  sprag --format csv       CSV output
+  sprag --project myproj   filter by project
+  sprag route-scan         detect recurring easy work → delegation candidates
+  sprag install            set up skill/hooks/statusline
+  sprag install --yes      take the defaults without asking
+  sprag uninstall          remove everything install added
+  sprag harness check      score the harness setup in CLAUDE.md
+  sprag harness analyze    run the harness transcript analysis manually
+  sprag last               most recent warning + how to handle it
+  sprag history            recent warning transitions
+  sprag handoff            write a session handoff file
+  sprag feedback "<msg>"   file a bug report / feature request (no browser needed)
+  sprag upgrade            install the latest release
+  sprag --install-hook     install cache-monitor PostToolUse hook
+  sprag --uninstall-hook   remove that hook
+  sprag --statusline       one-line output for Claude Code statusline
       --verbose / --no-color / --icon / --no-timer / --single-line
 
 Run any subcommand with --help for its own options where available.
-Bug reports & feature requests: https://github.com/rootstudioyaml/claude-token-saver/issues
+Bug reports & feature requests: https://github.com/rootstudioyaml/sprag/issues
 `;
 
 async function main() {
@@ -140,8 +140,8 @@ async function main() {
   // Designed for the auto-trigger skill so the user immediately sees
   // "what just fired and how to fix it" without having to read the whole
   // history file.
-  //   claude-token-saver last           # search last 1 day
-  //   claude-token-saver last --days 7  # widen the lookback
+  //   sprag last           # search last 1 day
+  //   sprag last --days 7  # widen the lookback
   if (args[0] === 'last') {
     return (await import('../src/commands/last.js')).run({ numArg });
   }
@@ -149,9 +149,9 @@ async function main() {
   // Subcommand: history — print recent warning transitions captured by the
   // statusline. One markdown file per day, persisted under the platform-
   // specific user-data dir.
-  //   claude-token-saver history              # last 7 days
-  //   claude-token-saver history --days 30    # custom window
-  //   claude-token-saver history --list       # just list available dates
+  //   sprag history              # last 7 days
+  //   sprag history --days 30    # custom window
+  //   sprag history --list       # just list available dates
   if (args[0] === 'history') {
     return (await import('../src/commands/history.js')).run({ hasFlag, numArg });
   }
@@ -161,8 +161,8 @@ async function main() {
   // session can pick up where this one stopped. Pairs with the cap-warn chip:
   // when statusline shows 🚨 5H 90%+, run this to back up state before the cap
   // hits.
-  //   claude-token-saver handoff             # write to cwd
-  //   claude-token-saver handoff --cwd PATH  # custom directory
+  //   sprag handoff             # write to cwd
+  //   sprag handoff --cwd PATH  # custom directory
   // Subcommand: feedback — file a bug report / feature request without a
   // browser. Tries gh CLI, then an anonymous form POST, then a local save
   // with a prefilled GitHub issue URL. See src/commands/feedback.js.
@@ -179,8 +179,8 @@ async function main() {
   // user can just mention chip wording and Claude responds. v2.6.0 dropped
   // the redundant /token-monitor slash command in favor of the skill alone;
   // a legacy command file is removed automatically. Cross-platform.
-  //   claude-token-saver install              # install/update the skill
-  //   claude-token-saver install --force      # overwrite existing skill file
+  //   sprag install              # install/update the skill
+  //   sprag install --force      # overwrite existing skill file
   if (args[0] === 'install') {
     return (await import('../src/commands/install.js')).run({ hasFlag });
   }
@@ -194,22 +194,22 @@ async function main() {
 
   // Subcommand: mode — persist statusline preferences so future runs pick
   // them up without flags or wrapper edits.
-  //   claude-token-saver mode                    # show current config
-  //   claude-token-saver mode icon verbose       # set icon + verbose
-  //   claude-token-saver mode reset              # clear back to defaults
+  //   sprag mode                    # show current config
+  //   sprag mode icon verbose       # set icon + verbose
+  //   sprag mode reset              # clear back to defaults
   if (args[0] === 'mode') {
     return (await import('../src/commands/mode.js')).run({ args });
   }
 
   // Subcommand: route-scan — detect recurring easy work on expensive models
   // and propose model-delegation ratchet rules. Zero token cost, fully local.
-  //   claude-token-saver route-scan                 # scan (24h cache) + print candidates
-  //   claude-token-saver route-scan --refresh       # force rescan
-  //   claude-token-saver route-scan --days 30       # wider lookback
-  //   claude-token-saver route-scan --hook          # SessionStart hook mode (context injection)
-  //   claude-token-saver route-scan dismiss <N>     # mute candidate R<N>
+  //   sprag route-scan                 # scan (24h cache) + print candidates
+  //   sprag route-scan --refresh       # force rescan
+  //   sprag route-scan --days 30       # wider lookback
+  //   sprag route-scan --hook          # SessionStart hook mode (context injection)
+  //   sprag route-scan dismiss <N>     # mute candidate R<N>
   // Promote a candidate to a ratchet rule (scope is always explicit):
-  //   claude-token-saver harness promote R<N> --project|--global
+  //   sprag harness promote R<N> --project|--global
   // brief --hook — UserPromptSubmit hook mode: per-session, change-triggered
   // briefing of state the statusline can only chip (ctx tier crossings,
   // mid-session route/rule-health changes). Silent when nothing changed.
@@ -223,39 +223,39 @@ async function main() {
 
   // Subcommand: korean — Korean writing guidance injected at session start,
   // so the rules apply in every project without an output-style switch.
-  //   claude-token-saver korean on | off | status | show
+  //   sprag korean on | off | status | show
   if (args[0] === 'korean') {
     return (await import('../src/commands/korean.js')).run({ args, hasFlag });
   }
 
   // Subcommand: cohesion — English sentence-connection guidance injected at
   // session start; the language-neutral half of the Korean supplement.
-  //   claude-token-saver cohesion on | off | status | show
+  //   sprag cohesion on | off | status | show
   if (args[0] === 'cohesion') {
     return (await import('../src/commands/cohesion.js')).run({ args, hasFlag });
   }
 
   // Subcommand: doc2md — convert pptx/xlsx/pdf/docx to Markdown before the
   // model reads them, so an unreadable binary never enters the context window.
-  //   claude-token-saver doc2md on | off | <file> | --clean
+  //   sprag doc2md on | off | <file> | --clean
   if (args[0] === 'doc2md') {
     return (await import('../src/commands/doc2md.js')).run({ args, hasFlag });
   }
 
   // Subcommand: seed — register the bundled starter rules (model-fitting
   // presets + curated ratchet rules), one answer at a time.
-  //   claude-token-saver seed | seed accept <id> --global|--project | seed skip <id>
+  //   sprag seed | seed accept <id> --global|--project | seed skip <id>
   if (args[0] === 'seed') {
     return (await import('../src/commands/seed.js')).run({ args, hasFlag });
   }
 
   // Subcommand: harness — manage the project's CLAUDE.md harness rules.
-  //   claude-token-saver harness init       # write CLAUDE.md (5 sections) + ratchet.md
-  //   claude-token-saver harness uninit     # remove harness block from CLAUDE.md (backup kept)
-  //   claude-token-saver harness check      # show 🅷 N/5 + which sections are missing
-  //   claude-token-saver harness promote "<rule>"  # append a rule to ratchet.md
-  //   claude-token-saver harness pull [--global|--project]  # register the package's curated preset rules (default global)
-  //   claude-token-saver harness off | on   # toggle the statusline 🅷 segment
+  //   sprag harness init       # write CLAUDE.md (5 sections) + ratchet.md
+  //   sprag harness uninit     # remove harness block from CLAUDE.md (backup kept)
+  //   sprag harness check      # show 🅷 N/5 + which sections are missing
+  //   sprag harness promote "<rule>"  # append a rule to ratchet.md
+  //   sprag harness pull [--global|--project]  # register the package's curated preset rules (default global)
+  //   sprag harness off | on   # toggle the statusline 🅷 segment
   if (args[0] === 'harness') {
     return (await import('../src/commands/harness.js')).run({ args, hasFlag });
   }
@@ -263,10 +263,10 @@ async function main() {
   // Subcommand: compact-window — audit / pin Claude Code's autoCompactWindow.
   // On a 1M-context model, compaction only fires near 800k unless the window is
   // capped; 200k sessions are exempt.
-  //   claude-token-saver compact-window                  # status
-  //   claude-token-saver compact-window set --global     # pin 200k (~/.claude/settings.json)
-  //   claude-token-saver compact-window set --project    # pin 200k (<root>/.claude/settings.json)
-  //   claude-token-saver compact-window off | on         # toggle the statusline warning
+  //   sprag compact-window                  # status
+  //   sprag compact-window set --global     # pin 200k (~/.claude/settings.json)
+  //   sprag compact-window set --project    # pin 200k (<root>/.claude/settings.json)
+  //   sprag compact-window off | on         # toggle the statusline warning
   if (args[0] === 'compact-window') {
     return (await import('../src/commands/compact-window.js')).run({ args, hasFlag });
   }
@@ -281,9 +281,9 @@ async function main() {
 
   // Subcommand: update-check — the registry lookup behind the ⬆ statusline
   // chip and the session-start upgrade offer.
-  //   claude-token-saver update-check              # print cached status
-  //   claude-token-saver update-check --refresh    # hit the registry now (detached child uses this)
-  //   claude-token-saver update-check --dismiss    # stop offering THIS version at session start
+  //   sprag update-check              # print cached status
+  //   sprag update-check --refresh    # hit the registry now (detached child uses this)
+  //   sprag update-check --dismiss    # stop offering THIS version at session start
   if (args[0] === 'update-check') {
     return (await import('../src/commands/update-check.js')).run({
       hasFlag,
@@ -292,8 +292,8 @@ async function main() {
   }
 
   // Subcommand: litellm-budget · LiteLLM 게이트웨이 키의 max_budget/spend 조회.
-  //   claude-token-saver litellm-budget            # 캐시된 예산 상태 출력
-  //   claude-token-saver litellm-budget --refresh  # 지금 프록시에 물어봄 (detached 자식이 사용)
+  //   sprag litellm-budget            # 캐시된 예산 상태 출력
+  //   sprag litellm-budget --refresh  # 지금 프록시에 물어봄 (detached 자식이 사용)
   if (args[0] === 'litellm-budget') {
     const { gatewayEnv, readBudgetState, refreshBudgetState } = await import('../src/litellm-budget.js');
     const quiet = hasFlag('--quiet');
@@ -319,8 +319,8 @@ async function main() {
 
   // Subcommand: upgrade — run the install command that matches how this copy
   // got here, then confirm the new version.
-  //   claude-token-saver upgrade          # install the latest release
-  //   claude-token-saver upgrade --print  # just show the command, run nothing
+  //   sprag upgrade          # install the latest release
+  //   sprag upgrade --print  # just show the command, run nothing
   if (args[0] === 'upgrade') {
     return (await import('../src/commands/upgrade.js')).run({
       hasFlag,
@@ -356,7 +356,7 @@ async function main() {
   // every scenario based on wall clock so a screen recorder picks them up.
   const demoArg = getArg('--demo');
 
-  // `claude-token-saver --demo table` (no --statusline) — full table view
+  // `sprag --demo table` (no --statusline) — full table view
   // with all six issue drill-downs at once, for marketing screencasts.
   if (!isStatusline && demoArg === 'table') {
     const { buildTableDemoData } = await import('../src/demo.js');
@@ -592,7 +592,7 @@ async function main() {
       }
     }
     // Persist transitions to ~/.config/claude-token-saver/history/YYYY-MM-DD.md
-    // so `claude-token-saver history` and the auto-skill can replay them.
+    // so `sprag history` and the auto-skill can replay them.
     try {
       const { recordChip, recordCapTransition } = await import('../src/history.js');
       recordChip(spikeChip, { detail: chipDetail });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sprag-cli",
-  "version": "3.41.0",
+  "version": "3.42.1",
   "description": "Sprag - a quality ratchet harness for AI coding agents: model-fitting delegation, ratchet rules, doc2md, Korean style gate. Same tool as claude-token-saver, under its new name.",
   "type": "module",
   "bin": {

package/src/advice.js

@@ -467,7 +467,7 @@ export const ISSUE_MESSAGES = {
  * and how do I fix it" without re-running the tool.
  *
  * The full multi-step advice still lives in `ISSUE_MESSAGES[code].actions()`;
- * `claude-token-saver last` prints that long form on demand.
+ * `sprag last` prints that long form on demand.
  */
 export const ISSUE_TIPS = {
   LARGE_INPUT_PER_REQUEST: {
@@ -536,8 +536,8 @@ export const CHIP_TO_CODES = {
  * because once the cap blocks you, you need a fresh session to continue.
  */
 export const CAP_TIPS = {
-  en: 'Run `claude-token-saver handoff` to back up state before the cap blocks you',
-  ko: '`claude-token-saver handoff` 실행해서 캡 도달 전에 상태 백업',
+  en: 'Run `sprag handoff` to back up state before the cap blocks you',
+  ko: '`sprag handoff` 실행해서 캡 도달 전에 상태 백업',
 };
 
 /**

package/src/brief.js

@@ -226,8 +226,8 @@ export async function runBrief({ sessionId, transcriptPath, now = Date.now() })
     }
     for (const [kind, x] of fresh) {
       items.push(kind === 'route'
-        ? `새 위임 후보가 감지되었습니다 — "${x.label}" 유형 ${x.count}회 반복(statusline의 route? R${x.id} 칩). 등록: claude-token-saver harness promote R${x.id} --project|--global (적용 범위는 사용자에게 확인) / 무시: route-scan dismiss ${x.id}`
-        : `승인된 위임 룰의 최근 에러율이 기준(20%)을 넘었습니다 — "${x.label}" (${x.healthSource === 'delegated' ? `위임 실행 ${x.delegatedRuns}건 중 에러율 ${Math.round((x.delegatedErrRate || 0) * 100)}%` : `유사 에피소드 기준 에러율 ${Math.round((x.errRate || 0) * 100)}%`}, statusline의 rule-health 칩). 조건 좁히기/제거를 사용자와 상의하세요: claude-token-saver route-scan rules`);
+        ? `새 위임 후보가 감지되었습니다 — "${x.label}" 유형 ${x.count}회 반복(statusline의 route? R${x.id} 칩). 등록: sprag harness promote R${x.id} --project|--global (적용 범위는 사용자에게 확인) / 무시: route-scan dismiss ${x.id}`
+        : `승인된 위임 룰의 최근 에러율이 기준(20%)을 넘었습니다 — "${x.label}" (${x.healthSource === 'delegated' ? `위임 실행 ${x.delegatedRuns}건 중 에러율 ${Math.round((x.delegatedErrRate || 0) * 100)}%` : `유사 에피소드 기준 에러율 ${Math.round((x.errRate || 0) * 100)}%`}, statusline의 rule-health 칩). 조건 좁히기/제거를 사용자와 상의하세요: sprag route-scan rules`);
     }
     s.briefed = [...briefed];
   } catch { /* caches unreadable — ctx briefing above still applies */ }
@@ -246,7 +246,7 @@ export async function runBrief({ sessionId, transcriptPath, now = Date.now() })
         briefed.add(sig);
         s.briefed = [...briefed];
         const now = st.window ? `현재 ${fmtK(st.window)}` : '현재 미설정';
-        items.push(`1M 컨텍스트 모델(${st.model})인데 autoCompactWindow가 ${now}입니다 — 자동 압축이 80만 토큰 근처에서야 걸려 그전까지 모든 요청이 전체 컨텍스트를 재과금합니다. 1M은 너무 크니 ${fmtK(st.recommendedMin)}~${fmtK(st.recommendedMax)} 범위를 권장합니다(그 범위 안이면 경고하지 않습니다). 1M 창 자체는 그대로 두고 압축 시점만 앞당깁니다. 등록: claude-token-saver compact-window set --global|--project [--value ${fmtK(st.recommendedMax)}] (기본 ${fmtK(st.recommended)}, 적용 범위는 사용자에게 확인) / 끄기: compact-window off`);
+        items.push(`1M 컨텍스트 모델(${st.model})인데 autoCompactWindow가 ${now}입니다 — 자동 압축이 80만 토큰 근처에서야 걸려 그전까지 모든 요청이 전체 컨텍스트를 재과금합니다. 1M은 너무 크니 ${fmtK(st.recommendedMin)}~${fmtK(st.recommendedMax)} 범위를 권장합니다(그 범위 안이면 경고하지 않습니다). 1M 창 자체는 그대로 두고 압축 시점만 앞당깁니다. 등록: sprag compact-window set --global|--project [--value ${fmtK(st.recommendedMax)}] (기본 ${fmtK(st.recommended)}, 적용 범위는 사용자에게 확인) / 끄기: compact-window off`);
       }
     }
   } catch { /* settings unreadable — other briefings above still apply */ }
@@ -257,7 +257,7 @@ export async function runBrief({ sessionId, transcriptPath, now = Date.now() })
 
   if (items.length === 0) return null;
   const lines = [
-    '[claude-token-saver 브리핑] 아래 상태 변화를 사용자에게 알려주세요. 진행 중인 답변 흐름을 끊지 말고, 답변 말미에 `※ [claude-token-saver]` 라벨을 달아 각 항목을 1~2줄로 요약해 전달하면 됩니다 (이 브리핑은 항목당 한 번만 주입됩니다):',
+    '[sprag 브리핑] 아래 상태 변화를 사용자에게 알려주세요. 진행 중인 답변 흐름을 끊지 말고, 답변 말미에 `※ [sprag]` 라벨을 달아 각 항목을 1~2줄로 요약해 전달하면 됩니다 (이 브리핑은 항목당 한 번만 주입됩니다):',
   ];
   for (const it of items) lines.push(`- ${it}`);
   return lines.join('\n');

package/src/cohesion.js

@@ -9,7 +9,7 @@
  *
  * Off by default for the same reason the Korean guidance is opt-in: a
  * token-saving tool has no business silently billing ~0.5k tokens a session.
- * Enable with `claude-token-saver cohesion on`.
+ * Enable with `sprag cohesion on`.
  *
  * When the Korean guidance is enabled, this block is NOT injected even if
  * enabled: the Korean supplement already carries the cohesion rules, and
@@ -62,7 +62,7 @@ export async function cohesionInjection({ cfg = loadConfig() } = {}) {
   const text = cohesionText();
   if (!text) return null;
   return [
-    '[claude-token-saver cohesion] Follow this guidance for English prose in this session.',
+    '[sprag cohesion] Follow this guidance for English prose in this session.',
     'The user enabled it in claude-token-saver.',
     '',
     text,

package/src/commands/brief.js

@@ -1,13 +1,13 @@
 /**
  * Subcommand: route-scan — detect recurring easy work on expensive models
  * and propose model-delegation ratchet rules. Zero token cost, fully local.
- *   claude-token-saver route-scan                 # scan (24h cache) + print candidates
- *   claude-token-saver route-scan --refresh       # force rescan
- *   claude-token-saver route-scan --days 30       # wider lookback
- *   claude-token-saver route-scan --hook          # SessionStart hook mode (context injection)
- *   claude-token-saver route-scan dismiss <N>     # mute candidate R<N>
+ *   sprag route-scan                 # scan (24h cache) + print candidates
+ *   sprag route-scan --refresh       # force rescan
+ *   sprag route-scan --days 30       # wider lookback
+ *   sprag route-scan --hook          # SessionStart hook mode (context injection)
+ *   sprag route-scan dismiss <N>     # mute candidate R<N>
  * Promote a candidate to a ratchet rule (scope is always explicit):
- *   claude-token-saver harness promote R<N> --project|--global
+ *   sprag harness promote R<N> --project|--global
  * brief --hook — UserPromptSubmit hook mode: per-session, change-triggered
  * briefing of state the statusline can only chip (ctx tier crossings,
  * mid-session route/rule-health changes). Silent when nothing changed.
@@ -18,7 +18,7 @@ import { debug } from '../debug.js';
 
 export async function run({ hasFlag }) {
     if (!hasFlag('--hook')) {
-      console.error('Usage: claude-token-saver brief --hook   (UserPromptSubmit hook mode)');
+      console.error('Usage: sprag brief --hook   (UserPromptSubmit hook mode)');
       process.exit(1);
     }
     const ctx = readStdinJson() || {};

package/src/commands/cohesion.js

@@ -1,9 +1,9 @@
 /**
  * Subcommand: cohesion — English sentence-connection guidance for every session.
- *   claude-token-saver cohesion on       # inject at session start, all projects
- *   claude-token-saver cohesion off      # stop injecting
- *   claude-token-saver cohesion status   # current state and cost
- *   claude-token-saver cohesion show     # print the guidance itself
+ *   sprag cohesion on       # inject at session start, all projects
+ *   sprag cohesion off      # stop injecting
+ *   sprag cohesion status   # current state and cost
+ *   sprag cohesion show     # print the guidance itself
  *
  * The English sibling of `korean on`, carrying only the language-neutral
  * cohesion rules (given-before-new, one referent per pronoun, subject
@@ -51,9 +51,9 @@ export async function run({ args }) {
   const suppressed = enabled && koreanStyleEnabled();
   if (lang === 'ko') {
     console.log(`cohesion: ${enabled ? 'on' : 'off'}${suppressed ? ' (korean 지침이 켜져 있어 주입은 생략됨)' : ''}`);
-    console.log('영어 산문의 문장 연결 지침을 세션 시작에 주입합니다. 켜기: claude-token-saver cohesion on');
+    console.log('영어 산문의 문장 연결 지침을 세션 시작에 주입합니다. 켜기: sprag cohesion on');
   } else {
     console.log(`cohesion: ${enabled ? 'on' : 'off'}${suppressed ? ' (suppressed while the Korean guidance is on — it already carries these rules)' : ''}`);
-    console.log('Injects English cohesion guidance at session start. Enable with: claude-token-saver cohesion on');
+    console.log('Injects English cohesion guidance at session start. Enable with: sprag cohesion on');
   }
 }

package/src/commands/compact-window.js

@@ -1,10 +1,10 @@
 /**
  * Subcommand: compact-window — audit / pin Claude Code's `autoCompactWindow`.
- *   claude-token-saver compact-window                      # status
- *   claude-token-saver compact-window set --global         # pin 500k in ~/.claude/settings.json
- *   claude-token-saver compact-window set --project        # pin 500k in <root>/.claude/settings.json
- *   claude-token-saver compact-window set --global --value 600k
- *   claude-token-saver compact-window off | on             # toggle the statusline warning
+ *   sprag compact-window                      # status
+ *   sprag compact-window set --global         # pin 500k in ~/.claude/settings.json
+ *   sprag compact-window set --project        # pin 500k in <root>/.claude/settings.json
+ *   sprag compact-window set --global --value 600k
+ *   sprag compact-window off | on             # toggle the statusline warning
  *
  * Scope is deliberately explicit for `set`: writing a global settings.json is
  * not something to guess at, and the non-TTY hook environment cannot prompt.
@@ -80,14 +80,14 @@ export async function run({ args, hasFlag }) {
     console.log(ko
       ? `  그 전까지 모든 요청이 전체 컨텍스트를 재과금합니다. 1M은 너무 크니 ${fmt(s.recommendedMin)}~${fmt(s.recommendedMax)} 범위를 권장합니다 (기본값 ${fmt(s.recommended)}, --value로 조절). 1M 창 자체는 그대로 두고 압축 시점만 앞당깁니다.`
       : `  Until then every request re-bills the whole context. 1M is too large — pick something in ${fmt(s.recommendedMin)}–${fmt(s.recommendedMax)} (default ${fmt(s.recommended)}, override with --value). The 1M window itself stays.`);
-    console.log(`\n  claude-token-saver compact-window set --global     (~/.claude/settings.json, ${fmt(s.recommended)})`);
-    console.log(`  claude-token-saver compact-window set --project    (<root>/.claude/settings.json, ${fmt(s.recommended)})`);
-    console.log(`  claude-token-saver compact-window set --global --value ${fmt(s.recommendedMax)}`);
+    console.log(`\n  sprag compact-window set --global     (~/.claude/settings.json, ${fmt(s.recommended)})`);
+    console.log(`  sprag compact-window set --project    (<root>/.claude/settings.json, ${fmt(s.recommended)})`);
+    console.log(`  sprag compact-window set --global --value ${fmt(s.recommendedMax)}`);
     console.log(ko ? '  (적용 범위는 사용자에게 먼저 확인할 것)' : '  (confirm the scope with the user first)');
     return;
   }
 
   console.error(`Unknown compact-window subcommand: ${sub}`);
-  console.error('Usage: claude-token-saver compact-window [status|set --global|--project [--value 500k]|off|on]');
+  console.error('Usage: sprag compact-window [status|set --global|--project [--value 500k]|off|on]');
   process.exit(1);
 }

package/src/commands/doc2md.js

@@ -2,11 +2,11 @@
  * Subcommand: doc2md — convert attached documents to Markdown before the
  * model reads them.
  *
- *   claude-token-saver doc2md              # status
- *   claude-token-saver doc2md on|off       # register / remove the Read hook
- *   claude-token-saver doc2md <file>       # convert one file by hand
- *   claude-token-saver doc2md --clean      # drop every cached conversion
- *   claude-token-saver doc2md --hook       # PreToolUse entry point
+ *   sprag doc2md              # status
+ *   sprag doc2md on|off       # register / remove the Read hook
+ *   sprag doc2md <file>       # convert one file by hand
+ *   sprag doc2md --clean      # drop every cached conversion
+ *   sprag doc2md --hook       # PreToolUse entry point
  */
 
 import { createRequire } from 'node:module';
@@ -162,5 +162,5 @@ export async function run({ args, hasFlag }) {
   console.log(`  hook:      ${hookRegistered() ? 'registered on Read' : 'not registered'}`);
   console.log('');
   if (!python) console.log(`Install the converter: ${doc2md.INSTALL_HINT}`);
-  console.log('Enable with: claude-token-saver doc2md on');
+  console.log('Enable with: sprag doc2md on');
 }

package/src/commands/feedback.js

@@ -2,8 +2,8 @@
  * Subcommand: feedback — submit a bug report or feature request from the
  * terminal (or from a Claude Code session) without opening a browser.
  *
- *   claude-token-saver feedback "statusline이 IntelliJ에서 깨져요"
- *   claude-token-saver feedback --title "cache chip" "5m TTL 칩이 안 사라짐"
+ *   sprag feedback "statusline이 IntelliJ에서 깨져요"
+ *   sprag feedback --title "cache chip" "5m TTL 칩이 안 사라짐"
  *
  * Why this exists: GitHub issues require a logged-in browser session, and
  * corporate networks often block github.com entirely. This command tries
@@ -25,13 +25,13 @@ import { join } from 'node:path';
 import os from 'node:os';
 import { debug } from '../debug.js';
 
-const REPO = 'rootstudioyaml/claude-token-saver';
+const REPO = 'rootstudioyaml/sprag';
 const ISSUES_URL = `https://github.com/${REPO}/issues`;
 
 // Anonymous submission endpoint (Google Form). A Google Form's formResponse
 // URL accepts unauthenticated POSTs, which is exactly the property a
 // login-free, GitHub-blocked-network path needs. Responses land in the
-// maintainer's "claude-token-saver 피드백 (Feedback)" form (published
+// maintainer's "sprag 피드백 (Feedback)" form (published
 // 2026-09-13, responder access: anyone with the link).
 //   id      — the /d/e/<id>/ segment of the form URL
 //   message — entry.NNNN field id of the message question
@@ -102,7 +102,7 @@ export async function run({ args, getArg, version, dataDir }) {
   const explicitTitle = getArg('--title');
 
   if (!message) {
-    console.log('usage: claude-token-saver feedback [--title "<제목>"] "<내용>"');
+    console.log('usage: sprag feedback [--title "<제목>"] "<내용>"');
     console.log(`       (GitHub에서 직접 제보: ${ISSUES_URL})`);
     process.exitCode = 1;
     return;