claude-token-saver 3.40.1 → 3.42.0

package/bin/cli.js

@@ -9,9 +9,9 @@
  *   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 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 claude-token-saver --install-hook     # install PostToolUse hook
  *   npx claude-token-saver --uninstall-hook   # remove hook
  *   npx claude-token-saver --hook-run         # internal: called by hook
@@ -98,16 +98,16 @@ Usage:
   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
+  sprag route-scan         detect recurring easy work → delegation candidates
+  sprag install            set up skill/hooks/statusline
+  sprag 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
+  sprag harness check      score the harness setup in CLAUDE.md
+  sprag 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)
+  sprag 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
@@ -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 });
   }
@@ -203,13 +203,13 @@ async function main() {
 
   // 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,21 +223,21 @@ 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 });
   }
@@ -250,12 +250,12 @@ async function main() {
   }
 
   // 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 });
   }
@@ -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,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-token-saver",
-  "version": "3.40.1",
-  "description": "Route the easy work your expensive Claude model keeps repeating down to haiku/sonnet — post-hoc session analysis, no realtime router, no extra LLM calls.",
+  "version": "3.42.0",
+  "description": "Legacy name of sprag-cli (Sprag) - same tool, kept publishing so existing installs stay current. Prefer: npm i -g sprag-cli",
   "type": "module",
   "bin": {
     "sprag": "bin/cli.js",
@@ -10,7 +10,8 @@
   "scripts": {
     "test": "node --test",
     "docs:statusline": "node scripts/docs-statusline.mjs",
-    "postinstall": "node bin/cli.js install || true"
+    "postinstall": "node bin/cli.js install || true",
+    "publish:legacy": "node scripts/publish-legacy.mjs"
   },
   "files": [
     "bin/",
@@ -25,6 +26,10 @@
     "node": ">=18"
   },
   "keywords": [
+    "sprag",
+    "ratchet",
+    "harness",
+    "ai-agent",
     "claude",
     "claude-code",
     "anthropic",
@@ -43,7 +48,6 @@
     "claude-code-statusline",
     "claude-code-cost",
     "model-fitting",
-    "ratchet",
     "agent-harness"
   ],
   "license": "MIT",

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 */ }
@@ -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줄로 요약해 전달하면 됩니다 (이 브리핑은 항목당 한 번만 주입됩니다):',
+    '[claude-token-saver 브리핑] 아래 상태 변화를 사용자에게 알려주세요. 진행 중인 답변 흐름을 끊지 말고, 답변 말미에 `※ [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/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
@@ -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;

package/src/commands/harness.js

@@ -1,11 +1,11 @@
 /**
  * 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
  */
 
 import { debug } from '../debug.js';
@@ -49,8 +49,8 @@ export async function run({ args, hasFlag }) {
           const sec = HARNESS_SECTIONS.find((x) => x.id === id);
           console.log(`  - ${id}: ${sec ? sec.heading.replace(/^#+\s*/, '') : ''}`);
         }
-        console.log('\nRun: claude-token-saver harness init        (this project)');
-        console.log('  or: claude-token-saver harness init --global  (all projects, ~/.claude/CLAUDE.md)');
+        console.log('\nRun: sprag harness init        (this project)');
+        console.log('  or: sprag harness init --global  (all projects, ~/.claude/CLAUDE.md)');
       } else {
         console.log('All 5 harness sections present. ✅');
       }
@@ -60,7 +60,7 @@ export async function run({ args, hasFlag }) {
         const dead = [!s.hasRatchetImport && 'ratchet.md', !s.hasModelRatchetImport && 'ratchet-model.md'].filter(Boolean).join(' + ');
         console.log(`\n⚠ ${dead} is NOT loaded into sessions — the harness block has no \`@\` import line for it.`);
         console.log('  Those rules are being written to a file nothing reads.');
-        console.log(`  Fix: claude-token-saver harness init${s.source === 'global' ? ' --global' : ''}   (updates the block in place)`);
+        console.log(`  Fix: sprag harness init${s.source === 'global' ? ' --global' : ''}   (updates the block in place)`);
       }
       // Imported ratchets are charged on every request, so their size matters.
       // Static `@` imports cannot be filtered at load time — the only lever is
@@ -71,7 +71,7 @@ export async function run({ args, hasFlag }) {
         const line = `ratchet.md [${sc}]: ${size.count} rules, ~${size.tokens} tok/request`;
         if (size.overBudget) {
           console.log(`\n⚠ ${line} — over the ~${RATCHET_TOKEN_BUDGET} token budget.`);
-          console.log(`  Trim: claude-token-saver harness prune${sc === 'global' ? ' --global' : ''} --older-than 6 --dry-run`);
+          console.log(`  Trim: sprag harness prune${sc === 'global' ? ' --global' : ''} --older-than 6 --dry-run`);
           console.log('  (project-specific rules belong in --project scope, not global.)');
         } else {
           console.log(`${line}`);
@@ -138,8 +138,8 @@ export async function run({ args, hasFlag }) {
       }
       const raw = promoteArgs.filter((_, i) => !scopeFlags.has(i)).join(' ').trim();
       if (!raw) {
-        console.error('Usage: claude-token-saver harness promote [--global|--project] <N>  # from statusline 🅷⚠ ratchet? #N');
-        console.error('   or: claude-token-saver harness promote [--global|--project] "<rule text>"');
+        console.error('Usage: sprag harness promote [--global|--project] <N>  # from statusline 🅷⚠ ratchet? #N');
+        console.error('   or: sprag harness promote [--global|--project] "<rule text>"');
         process.exit(1);
       }
       let rule = raw;
@@ -173,7 +173,7 @@ export async function run({ args, hasFlag }) {
         const rs = await import('../route-scan.js');
         const cand = (rs.openCandidates(rs.readRouteScan()) || []).find((c) => c.id === n);
         if (!cand) {
-          console.error(`No open route candidate R${n}. Run: claude-token-saver route-scan`);
+          console.error(`No open route candidate R${n}. Run: sprag route-scan`);
           process.exit(1);
         }
         rule = lang === 'ko' ? cand.rule : (cand.ruleEn || cand.rule);
@@ -229,7 +229,7 @@ export async function run({ args, hasFlag }) {
             console.error(`Route candidate R${routeCandidateId} was detected in another project (${routeCandidate.project}),`);
             console.error('but this cached scan predates project-path tracking.');
             console.error('Re-scan to capture it, then promote again:');
-            console.error('  claude-token-saver route-scan --refresh');
+            console.error('  sprag route-scan --refresh');
             process.exit(1);
           }
         }
@@ -261,8 +261,8 @@ export async function run({ args, hasFlag }) {
           ? `(route candidate R${routeCandidateId} resolved — 다음 세션부터 자동 위임, 이후 스캔마다 로그 기반 갱신됩니다)`
           : `(route candidate R${routeCandidateId} resolved — delegation applies from the next session, refreshed from logs on every rescan)`);
         console.log(lang === 'ko'
-          ? '룰 목록/제거: claude-token-saver route-scan rules [rm <N>]'
-          : 'List / remove: claude-token-saver route-scan rules [rm <N>]');
+          ? '룰 목록/제거: sprag route-scan rules [rm <N>]'
+          : 'List / remove: sprag route-scan rules [rm <N>]');
         // Event-triggered refresh: establish the new rule's stat baseline
         // right away instead of waiting for the next data-gated rescan.
         try {
@@ -345,8 +345,8 @@ export async function run({ args, hasFlag }) {
       }
       if (r.skippedRules && r.added.length) console.log(`   (${r.skippedRules} already present — skipped)`);
       console.log(lang === 'ko'
-        ? '\n필요 없는 룰은 언제든: claude-token-saver harness list / rm <N>'
-        : '\nDrop any rule you do not want: claude-token-saver harness list / rm <N>');
+        ? '\n필요 없는 룰은 언제든: sprag harness list / rm <N>'
+        : '\nDrop any rule you do not want: sprag harness list / rm <N>');
       return;
     }
 
@@ -365,8 +365,8 @@ export async function run({ args, hasFlag }) {
       };
       if (wantProject) print('project');
       if (wantGlobal) print('global');
-      console.log('Remove with: claude-token-saver harness rm [--global|--project] <N>');
-      console.log('Archive in bulk:  claude-token-saver harness prune [--global] [--tag <t>] [--older-than <months>] [--dry-run]');
+      console.log('Remove with: sprag harness rm [--global|--project] <N>');
+      console.log('Archive in bulk:  sprag harness prune [--global] [--tag <t>] [--older-than <months>] [--dry-run]');
       return;
     }
 
@@ -406,7 +406,7 @@ export async function run({ args, hasFlag }) {
       const rmArgs = args.slice(2).filter((a) => a !== '--global' && a !== '--project');
       const raw = (rmArgs[0] || '').trim();
       if (!/^\d+$/.test(raw)) {
-        console.error('Usage: claude-token-saver harness rm [--global|--project] <N>   # N from `harness list`');
+        console.error('Usage: sprag harness rm [--global|--project] <N>   # N from `harness list`');
         process.exit(1);
       }
       const n = parseInt(raw, 10);
@@ -454,6 +454,6 @@ export async function run({ args, hasFlag }) {
     }
 
     console.error(`Unknown harness subcommand: ${sub}`);
-    console.error('Usage: claude-token-saver harness [check|init|uninit [--purge-ratchet]|promote "<rule>"|pull [--global|--project]|list|rm <N>|prune [--tag <t>] [--older-than <months>] [--dry-run]|off|on]');
+    console.error('Usage: sprag harness [check|init|uninit [--purge-ratchet]|promote "<rule>"|pull [--global|--project]|list|rm <N>|prune [--tag <t>] [--older-than <months>] [--dry-run]|off|on]');
     process.exit(1);
 }

package/src/commands/install.js

@@ -3,10 +3,10 @@
  * 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
- *   claude-token-saver install --yes        # take the defaults instead of asking
- *   claude-token-saver install --no-input   # same as --yes; also implied by CTS_NO_INPUT=1
+ *   sprag install              # install/update the skill
+ *   sprag install --force      # overwrite existing skill file
+ *   sprag install --yes        # take the defaults instead of asking
+ *   sprag install --no-input   # same as --yes; also implied by CTS_NO_INPUT=1
  */
 
 import { debug } from '../debug.js';
@@ -94,8 +94,8 @@ export async function run({ hasFlag }) {
           s = installStatusline({ force: true });
         } else {
           s = { ...s, reason: lang === 'ko'
-            ? '기존 statusline을 유지했습니다. 교체하려면 `claude-token-saver install --force`'
-            : 'kept your statusline — replace later with `claude-token-saver install --force`' };
+            ? '기존 statusline을 유지했습니다. 교체하려면 `sprag install --force`'
+            : 'kept your statusline — replace later with `sprag install --force`' };
         }
       }
       const verb = s.action === 'exists' ? 'already configured (refreshInterval=5)'
@@ -178,8 +178,8 @@ export async function run({ hasFlag }) {
         }
         if (!proceed) {
           console.log(lang === 'ko'
-            ? '  harness: 건너뛰었습니다 — 나중에 `claude-token-saver harness init --global` 로 설정할 수 있습니다.'
-            : '  harness: skipped — set it up later with `claude-token-saver harness init --global`.');
+            ? '  harness: 건너뛰었습니다 — 나중에 `sprag harness init --global` 로 설정할 수 있습니다.'
+            : '  harness: skipped — set it up later with `sprag harness init --global`.');
           throw new SkipStep();
         }
         const h = harnessInit({ scope: 'global' });
@@ -194,8 +194,8 @@ export async function run({ hasFlag }) {
           ? '  harness: 5원칙을 ~/.claude/CLAUDE.md 에 설정했습니다 — statusline에 🅷 5/5 가 표시됩니다.'
           : '  harness: 5 principles installed in ~/.claude/CLAUDE.md — the statusline now shows 🅷 5/5.');
         console.log(lang === 'ko'
-          ? '           되돌리려면: claude-token-saver harness uninit --global'
-          : '           to undo: claude-token-saver harness uninit --global');
+          ? '           되돌리려면: sprag harness uninit --global'
+          : '           to undo: sprag harness uninit --global');
       }
     } catch (e) {
       // A declined prompt already printed its own line; only real failures fall
@@ -206,8 +206,8 @@ export async function run({ hasFlag }) {
       // in place, and `harness init` remains available as a manual step.
       debug('install:harness-init', e);
       console.log(lang === 'ko'
-        ? '  harness: 자동 설정을 건너뛰었습니다 — `claude-token-saver harness init --global` 로 직접 설정하세요.'
-        : '  harness: auto-setup skipped — run `claude-token-saver harness init --global` yourself.');
+        ? '  harness: 자동 설정을 건너뛰었습니다 — `sprag harness init --global` 로 직접 설정하세요.'
+        : '  harness: auto-setup skipped — run `sprag harness init --global` yourself.');
       }
     }
 
@@ -264,12 +264,12 @@ export async function run({ hasFlag }) {
         if (interactive || enable) ks.setKoreanStyleEnabled(enable);
         if (enable) {
           console.log(lang === 'ko'
-            ? '  korean: 켰습니다 — 모든 프로젝트의 세션 시작 시 주입됩니다. 끄려면 `claude-token-saver korean off`.'
-            : '  korean: enabled — injected at session start in every project. Turn off with `claude-token-saver korean off`.');
+            ? '  korean: 켰습니다 — 모든 프로젝트의 세션 시작 시 주입됩니다. 끄려면 `sprag korean off`.'
+            : '  korean: enabled — injected at session start in every project. Turn off with `sprag korean off`.');
         } else {
           console.log(lang === 'ko'
-            ? '  korean: 꺼 두었습니다 — 나중에 `claude-token-saver korean on` 으로 켤 수 있습니다.'
-            : '  korean: left off — enable later with `claude-token-saver korean on`.');
+            ? '  korean: 꺼 두었습니다 — 나중에 `sprag korean on` 으로 켤 수 있습니다.'
+            : '  korean: left off — enable later with `sprag korean on`.');
         }
       }
     } catch (e) {

package/src/commands/korean.js

@@ -1,9 +1,9 @@
 /**
  * Subcommand: korean — Korean writing guidance for every session.
- *   claude-token-saver korean on       # inject at session start, all projects
- *   claude-token-saver korean off      # stop injecting
- *   claude-token-saver korean status   # current state, cost, and provenance
- *   claude-token-saver korean show     # print the guidance itself
+ *   sprag korean on       # inject at session start, all projects
+ *   sprag korean off      # stop injecting
+ *   sprag korean status   # current state, cost, and provenance
+ *   sprag korean show     # print the guidance itself
  *
  * Why this exists rather than pointing users at Claude Code's output styles:
  * an output style is one global slot, so turning it on takes the slot away
@@ -18,8 +18,8 @@
  * reads the finished file. `korean on` therefore also installs a PostToolUse
  * hook that runs the machine-checkable clauses over the prose the model just
  * wrote:
- *   claude-token-saver korean lint block|warn|off   # how findings are handled
- *   claude-token-saver korean lint <file...>        # check files on disk
+ *   sprag korean lint block|warn|off   # how findings are handled
+ *   sprag korean lint <file...>        # check files on disk
  */
 
 // Enforcement is only useful if it is on by default — a check the user has to
@@ -108,7 +108,7 @@ export async function run({ args, hasFlag }) {
       return;
     }
     if (!['all', 'prose'].includes(next)) {
-      console.error('Usage: claude-token-saver korean lint scope [all|prose]');
+      console.error('Usage: sprag korean lint scope [all|prose]');
       process.exit(1);
     }
     cfg.koreanStyle = cfg.koreanStyle || {};
@@ -135,7 +135,7 @@ export async function run({ args, hasFlag }) {
       return;
     }
     if (!['block', 'warn', 'off'].includes(mode)) {
-      console.error('Usage: claude-token-saver korean lint [block|warn|off] | korean lint <file...>');
+      console.error('Usage: sprag korean lint [block|warn|off] | korean lint <file...>');
       process.exit(1);
     }
     cfg.koreanStyle = cfg.koreanStyle || {};
@@ -201,20 +201,20 @@ export async function run({ args, hasFlag }) {
   if (lang === 'ko') {
     console.log(`한국어 문체 지침: ${on ? '켜짐' : '꺼짐'}`);
     console.log(`  비용: 세션당 약 ${tokens} 토큰 (세션 시작 1회 주입)`);
-    console.log(`  쓰기 시점 검사: ${koreanLintMode(loadConfig())}, 범위 ${koreanLintScope(loadConfig())} (바꾸려면 claude-token-saver korean lint block|warn|off, korean lint scope all|prose)`);
+    console.log(`  쓰기 시점 검사: ${koreanLintMode(loadConfig())}, 범위 ${koreanLintScope(loadConfig())} (바꾸려면 sprag korean lint block|warn|off, korean lint scope all|prose)`);
     console.log(`  출처: ${ks.KOREAN_STYLE_SOURCE}`);
     console.log(`  라이선스 전문: ${ks.KOREAN_STYLE_LICENSE_PATH}`);
     console.log(on
-      ? '  끄려면: claude-token-saver korean off'
-      : '  켜려면: claude-token-saver korean on');
+      ? '  끄려면: sprag korean off'
+      : '  켜려면: sprag korean on');
   } else {
     console.log(`Korean writing guidance: ${on ? 'on' : 'off'}`);
     console.log(`  Cost: ~${tokens} tokens per session (injected once at session start)`);
-    console.log(`  Write-time check: ${koreanLintMode(loadConfig())}, scope ${koreanLintScope(loadConfig())} (change with: claude-token-saver korean lint block|warn|off, korean lint scope all|prose)`);
+    console.log(`  Write-time check: ${koreanLintMode(loadConfig())}, scope ${koreanLintScope(loadConfig())} (change with: sprag korean lint block|warn|off, korean lint scope all|prose)`);
     console.log(`  Source: ${ks.KOREAN_STYLE_SOURCE}`);
     console.log(`  License text: ${ks.KOREAN_STYLE_LICENSE_PATH}`);
     console.log(on
-      ? '  Turn off with: claude-token-saver korean off'
-      : '  Turn on with: claude-token-saver korean on');
+      ? '  Turn off with: sprag korean off'
+      : '  Turn on with: sprag korean on');
   }
 }

package/src/commands/route-scan.js

@@ -111,7 +111,7 @@ export async function run({ args, hasFlag, numArg }) {
         const n = parseInt(args[3], 10);
         const removed = Number.isFinite(n) ? mr.removeModelRule(n) : null;
         if (!removed) {
-          console.error('Usage: claude-token-saver route-scan rules rm <N>   # N from `route-scan rules`');
+          console.error('Usage: sprag route-scan rules rm <N>   # N from `route-scan rules`');
           process.exit(1);
         }
         // A target whose last rule was removed gets its (tool-owned) file deleted.
@@ -181,20 +181,20 @@ export async function run({ args, hasFlag, numArg }) {
             + '\n  Map it under modelAliases in profile-map.json, then run route-scan --refresh.');
       }
       console.log(lang === 'ko'
-        ? '\n제거: claude-token-saver route-scan rules rm <N>'
-        : '\nRemove with: claude-token-saver route-scan rules rm <N>');
+        ? '\n제거: sprag route-scan rules rm <N>'
+        : '\nRemove with: sprag route-scan rules rm <N>');
       return;
     }
 
     if (args[1] === 'dismiss') {
       const n = parseInt(args[2], 10);
       if (!Number.isFinite(n)) {
-        console.error('Usage: claude-token-saver route-scan dismiss <N>   # N from `route? R<N>`');
+        console.error('Usage: sprag route-scan dismiss <N>   # N from `route? R<N>`');
         process.exit(1);
       }
       const cand = rs.resolveCandidate(n);
       if (!cand) {
-        console.error(`No route candidate R${n}. Run: claude-token-saver route-scan`);
+        console.error(`No route candidate R${n}. Run: sprag route-scan`);
         process.exit(1);
       }
       console.log(lang === 'ko'
@@ -301,16 +301,16 @@ export async function run({ args, hasFlag, numArg }) {
         if (u && u.available && !u.dismissed) {
           updateBlock = lang === 'ko'
             ? [
-                `[claude-token-saver update] 새 버전이 나와 있습니다: v${u.current} → ${u.latest}.`,
+                `[sprag update] 새 버전이 나와 있습니다: v${u.current} → ${u.latest}.`,
                 '사용자에게 지금 업그레이드할지 물어보고, 승낙하면 아래 명령을 실행하십시오. 묻지 않고 설치하지는 마십시오.',
                 '  claude-token-saver upgrade            # 업그레이드 실행',
-                '  claude-token-saver update-check --dismiss   # 사용자가 원치 않으면 (다음 버전이 나올 때까지 다시 묻지 않습니다)',
+                '  sprag update-check --dismiss   # 사용자가 원치 않으면 (다음 버전이 나올 때까지 다시 묻지 않습니다)',
               ].join('\n')
             : [
-                `[claude-token-saver update] A newer version is available: v${u.current} → ${u.latest}.`,
+                `[sprag update] A newer version is available: v${u.current} → ${u.latest}.`,
                 'Ask the user whether to upgrade now, and run the command below only if they agree. Do not install without asking.',
                 '  claude-token-saver upgrade                  # perform the upgrade',
-                '  claude-token-saver update-check --dismiss   # if they decline (stays quiet until a newer release)',
+                '  sprag update-check --dismiss   # if they decline (stays quiet until a newer release)',
               ].join('\n');
         }
       } catch (e) { debug('route-scan:update-check', e); /* the offer is optional */ }
@@ -332,10 +332,10 @@ export async function run({ args, hasFlag, numArg }) {
       const lines = [];
       if (open.length > 0) {
         if (lang === 'ko') {
-          lines.push(`[claude-token-saver route-scan] 최근 ${cache.days}일 세션에서 비싼 모델(opus/fable)이 반복 처리해 온, 더 싼 모델로 넘겨도 되는 작업이 감지되었습니다.`);
+          lines.push(`[sprag route-scan] 최근 ${cache.days}일 세션에서 비싼 모델(opus/fable)이 반복 처리해 온, 더 싼 모델로 넘겨도 되는 작업이 감지되었습니다.`);
           lines.push('(R<N>은 후보 번호, T2/T1은 난이도 등급입니다 — 사용자에게 전달할 때는 코드가 아니라 아래 풀어쓴 설명으로 브리핑하세요)');
         } else {
-          lines.push(`[claude-token-saver route-scan] Over the last ${cache.days} days, expensive models (opus/fable) repeatedly handled work that a cheaper model could take.`);
+          lines.push(`[sprag route-scan] Over the last ${cache.days} days, expensive models (opus/fable) repeatedly handled work that a cheaper model could take.`);
           lines.push('(R<N> is the candidate id, T2/T1 the difficulty tier — brief the user with the spelled-out wording below, not the codes.)');
         }
         for (const c of open) {
@@ -356,12 +356,12 @@ export async function run({ args, hasFlag, numArg }) {
         }
         if (lang === 'ko') {
           lines.push('등록하면 다음 세션부터 자동 위임됩니다. 사용자에게 등록 여부를 물을 때 위 룰 원문을 그대로 보여주고, 적용 범위까지 확인한 뒤 실행하세요:');
-          lines.push('  claude-token-saver harness promote R<N> --project|--global   # 적용 범위는 반드시 사용자에게 확인');
-          lines.push('  claude-token-saver route-scan dismiss <N>                    # 사용자가 원치 않으면');
+          lines.push('  sprag harness promote R<N> --project|--global   # 적용 범위는 반드시 사용자에게 확인');
+          lines.push('  sprag route-scan dismiss <N>                    # 사용자가 원치 않으면');
         } else {
           lines.push('Once registered, delegation happens automatically from the next session. Show the user the rule text verbatim, confirm the scope with them, then run:');
-          lines.push('  claude-token-saver harness promote R<N> --project|--global   # ALWAYS confirm the scope with the user first');
-          lines.push('  claude-token-saver route-scan dismiss <N>                    # if they do not want it');
+          lines.push('  sprag harness promote R<N> --project|--global   # ALWAYS confirm the scope with the user first');
+          lines.push('  sprag route-scan dismiss <N>                    # if they do not want it');
         }
       }
       if (reviewRules.length > 0) {
@@ -383,12 +383,12 @@ export async function run({ args, hasFlag, numArg }) {
           lines.push(`      "${r.rule}"`);
         }
         lines.push(lang === 'ko'
-          ? '  제거: claude-token-saver route-scan rules rm <N>'
-          : '  remove with: claude-token-saver route-scan rules rm <N>');
+          ? '  제거: sprag route-scan rules rm <N>'
+          : '  remove with: sprag route-scan rules rm <N>');
       }
       lines.push(lang === 'ko'
-        ? '위 내용은 사용자의 첫 메시지 주제와 무관하더라도(단순 인사여도) 첫 응답 말미에 `※ [claude-token-saver]` 라벨을 달아 요약 브리핑하세요 — 사용자가 물어볼 때까지 기다리지 말 것.'
-        : 'Summarize the above at the end of your first response under a `※ [claude-token-saver]` label, even if the user\'s first message is unrelated (a bare greeting counts) — do not wait to be asked.');
+        ? '위 내용은 사용자의 첫 메시지 주제와 무관하더라도(단순 인사여도) 첫 응답 말미에 `※ [sprag]` 라벨을 달아 요약 브리핑하세요 — 사용자가 물어볼 때까지 기다리지 말 것.'
+        : 'Summarize the above at the end of your first response under a `※ [sprag]` label, even if the user\'s first message is unrelated (a bare greeting counts) — do not wait to be asked.');
       // Style first, briefing second: the briefing is Korean prose too, so the
       // guidance has to be in context before the model reads it.
       if (koreanBlock) console.log(koreanBlock + '\n');
@@ -446,8 +446,8 @@ export async function run({ args, hasFlag, numArg }) {
     }
     console.log('');
     console.log(lang === 'ko' ? '등록 / 무시:' : 'Promote / dismiss:');
-    console.log('  claude-token-saver harness promote R<N> --project|--global');
-    console.log('  claude-token-saver route-scan dismiss <N>');
+    console.log('  sprag harness promote R<N> --project|--global');
+    console.log('  sprag route-scan dismiss <N>');
     // 최초 1회만 — 매번 찍으면 도구가 광고판이 된다 (CTS_NO_NOTE=1 로 끔)
     (await import('../first-run-note.js')).printOnce('route-scan', lang);
     return;

package/src/commands/update-check.js

@@ -1,11 +1,11 @@
 /**
  * Subcommand: update-check — everything around "is a newer version out".
  *
- *   claude-token-saver update-check              # print the cached answer
- *   claude-token-saver update-check --refresh    # ask the registry now
- *   claude-token-saver update-check --refresh --quiet
+ *   sprag update-check              # print the cached answer
+ *   sprag update-check --refresh    # ask the registry now
+ *   sprag update-check --refresh --quiet
  *                                                # what the detached background child runs
- *   claude-token-saver update-check --dismiss    # stop offering this version at session start
+ *   sprag update-check --dismiss    # stop offering this version at session start
  *
  * The statusline never calls the --refresh path directly; it spawns this
  * command detached so the render itself stays offline and instant.
@@ -71,7 +71,7 @@ export async function run({ hasFlag, version }) {
     : `Up to date (v${version}).`);
   if (!s.latest) {
     console.log(lang === 'ko'
-      ? `아직 확인된 기록이 없습니다. 지금 확인하려면: claude-token-saver update-check --refresh (기록 파일: ${updateStatePath()})`
-      : `No check has completed yet. Run: claude-token-saver update-check --refresh (state: ${updateStatePath()})`);
+      ? `아직 확인된 기록이 없습니다. 지금 확인하려면: sprag update-check --refresh (기록 파일: ${updateStatePath()})`
+      : `No check has completed yet. Run: sprag update-check --refresh (state: ${updateStatePath()})`);
   }
 }

package/src/doc2md.cjs

@@ -158,7 +158,7 @@ function banner(sourcePath, saving) {
   const src = fs.statSync(sourcePath);
   const lines = [
     '<!--',
-    'claude-token-saver doc2md 가 변환한 파일입니다. 직접 편집하지 마십시오.',
+    'sprag doc2md 가 변환한 파일입니다. 직접 편집하지 마십시오.',
     `원본: ${path.resolve(sourcePath)} (${humanBytes(src.size)})`,
     `변환: ${new Date().toISOString()} · Markdown ${humanBytes(Buffer.byteLength(saving.markdown, 'utf8'))} · 약 ${saving.tokens.toLocaleString('en-US')} 토큰`,
   ];
@@ -642,7 +642,7 @@ function markNoticeShown() {
   } catch { /* an unwritable state dir just means the notice repeats */ }
 }
 
-const INSTALL_HINT = 'claude-token-saver doc2md install-converter';
+const INSTALL_HINT = 'sprag doc2md install-converter';
 
 /**
  * Decide what to tell Claude Code about one PreToolUse(Read) payload.
@@ -847,8 +847,8 @@ function contextForPrompt(payload, opts = {}) {
         : `  ${name}: the converter needs Python 3.10+, and none is on PATH (macOS ships 3.9). Tell the user to install a newer Python, e.g. \`brew install python\`.`);
     } else if (result.reason === 'no-figparser') {
       lines.push(lang === 'ko'
-        ? `  ${name}: .fig 파서가 없어 변환하지 못했습니다. 설치: claude-token-saver doc2md install-converter`
-        : `  ${name}: no .fig parser installed. Install it with: claude-token-saver doc2md install-converter`);
+        ? `  ${name}: .fig 파서가 없어 변환하지 못했습니다. 설치: sprag doc2md install-converter`
+        : `  ${name}: no .fig parser installed. Install it with: sprag doc2md install-converter`);
     } else if (result.reason === 'sensitive') {
       lines.push(lang === 'ko'
         ? `  ${name}: 파일명이 민감 문서 패턴에 걸려 변환하지 않았습니다.`
@@ -861,8 +861,8 @@ function contextForPrompt(payload, opts = {}) {
   }
   if (paths.length > targets.length) {
     lines.push(lang === 'ko'
-      ? `  (문서 ${paths.length}개 가운데 앞 ${targets.length}개만 변환했습니다. 나머지는 \`claude-token-saver doc2md <경로>\` 로 변환하십시오.)`
-      : `  (converted the first ${targets.length} of ${paths.length} documents; run \`claude-token-saver doc2md <path>\` for the rest.)`);
+      ? `  (문서 ${paths.length}개 가운데 앞 ${targets.length}개만 변환했습니다. 나머지는 \`sprag doc2md <경로>\` 로 변환하십시오.)`
+      : `  (converted the first ${targets.length} of ${paths.length} documents; run \`sprag doc2md <path>\` for the rest.)`);
   }
 
   return lang === 'ko'
@@ -870,15 +870,15 @@ function contextForPrompt(payload, opts = {}) {
       '[doc2md] 이 프롬프트에 문서 경로가 있어 Markdown 으로 변환해 두었습니다.',
       ...lines,
       '원본 대신 위 변환본을 Read 하십시오. pptx·xlsx·docx 는 Read 도구가 이진 파일이라며 거부하므로 원본을 직접 열 수 없습니다.',
-    '변환이 일어났다는 사실은 사용자에게도 보여야 하므로, 답변 첫 줄에 변환한 문서마다 다음 형식으로 한 줄씩 출력하십시오: `📄 [claude-token-saver] doc2md: <파일명> (<원본 크기> → <Markdown 크기>, 약 <토큰> 토큰)`. 절감액이 함께 안내됐다면 그 금액도 같은 줄 끝에 덧붙이십시오.',
-      '경로가 주어지지 않은 문서를 열어야 할 때는 `claude-token-saver doc2md <경로>` 를 실행해 변환본 경로를 얻으십시오.',
+    '변환이 일어났다는 사실은 사용자에게도 보여야 하므로, 답변 첫 줄에 변환한 문서마다 다음 형식으로 한 줄씩 출력하십시오: `📄 [sprag] doc2md: <파일명> (<원본 크기> → <Markdown 크기>, 약 <토큰> 토큰)`. 절감액이 함께 안내됐다면 그 금액도 같은 줄 끝에 덧붙이십시오.',
+      '경로가 주어지지 않은 문서를 열어야 할 때는 `sprag doc2md <경로>` 를 실행해 변환본 경로를 얻으십시오.',
     ].join('\n')
     : [
       '[doc2md] This prompt names document paths, which have been converted to Markdown:',
       ...lines,
       'Read the conversions above rather than the originals: Read refuses pptx/xlsx/docx as binary files, so the originals cannot be opened directly.',
-    'The user cannot see that any of this happened, so open your reply with one line per converted document: `📄 [claude-token-saver] doc2md: <name> (<source size> → <markdown size>, ~<tokens> tokens)`, adding the saving above if one was reported.',
-      'For a document whose path was not given here, run `claude-token-saver doc2md <path>` to get its conversion.',
+    'The user cannot see that any of this happened, so open your reply with one line per converted document: `📄 [sprag] doc2md: <name> (<source size> → <markdown size>, ~<tokens> tokens)`, adding the saving above if one was reported.',
+      'For a document whose path was not given here, run `sprag doc2md <path>` to get its conversion.',
     ].join('\n');
 }
 
@@ -893,14 +893,14 @@ function sessionNote(lang = 'en') {
   if (lang === 'ko') {
     return [
       '[doc2md] 문서(pptx·xlsx·pdf·docx)를 다룰 때의 규칙입니다.',
-      '  문서를 열어야 하는데 Read 가 이진 파일이라며 거부하면, `claude-token-saver doc2md <경로>` 를 실행하고 그 결과로 나온 .md 를 Read 하십시오.',
+      '  문서를 열어야 하는데 Read 가 이진 파일이라며 거부하면, `sprag doc2md <경로>` 를 실행하고 그 결과로 나온 .md 를 Read 하십시오.',
       '  사용자가 문서를 메시지에 직접 첨부했다면, 첨부는 내용 전체가 컨텍스트에 실려 토큰을 크게 씁니다. 다음부터는 첨부 대신 파일 경로를 적어 달라고 안내하십시오. 경로로 주면 변환본만 읽습니다.',
-      '  변환은 단방향입니다. 변환본 .md 를 고쳐도 원본에는 반영되지 않습니다. 문서 수정 요청을 받으면: ① 원본을 복사하고 ② 복사본을 스크립트로 수정하십시오. pptx·docx·xlsx 는 도구 venv 파이썬에 python-pptx·python-docx·openpyxl 이 준비되어 있고(`claude-token-saver doc2md` 상태 출력에 경로가 나옵니다), .fig 는 openfig-core 로 편집·재인코드합니다. ③ 수정한 복사본을 doc2md 로 재변환해 변경이 들어갔는지 검증하십시오. 차트·이미지 같은 시각 요소는 변환본에 안 잡히므로 텍스트 검증만으로 완료를 단정하지 마십시오.',
+      '  변환은 단방향입니다. 변환본 .md 를 고쳐도 원본에는 반영되지 않습니다. 문서 수정 요청을 받으면: ① 원본을 복사하고 ② 복사본을 스크립트로 수정하십시오. pptx·docx·xlsx 는 도구 venv 파이썬에 python-pptx·python-docx·openpyxl 이 준비되어 있고(`sprag doc2md` 상태 출력에 경로가 나옵니다), .fig 는 openfig-core 로 편집·재인코드합니다. ③ 수정한 복사본을 doc2md 로 재변환해 변경이 들어갔는지 검증하십시오. 차트·이미지 같은 시각 요소는 변환본에 안 잡히므로 텍스트 검증만으로 완료를 단정하지 마십시오.',
     ].join('\n');
   }
   return [
     '[doc2md] Handling documents (pptx/xlsx/pdf/docx):',
-    '  If Read refuses a document as a binary file, run `claude-token-saver doc2md <path>` and Read the .md it prints.',
+    '  If Read refuses a document as a binary file, run `sprag doc2md <path>` and Read the .md it prints.',
     '  If the user attached a document to their message, its full contents were billed into the context. Tell them that naming the file path instead is far cheaper, since only the converted Markdown gets read.',
     '  Conversions are one-way: editing the cached .md changes nothing in the source. When asked to modify a document: ① copy the original, ② edit the COPY with a script — the managed venv python has python-pptx/python-docx/openpyxl, and .fig edits go through openfig-core — then ③ re-convert the copy with doc2md to verify the change landed. Charts and images do not appear in conversions, so text verification alone does not prove visual edits.',
   ].join('\n');
@@ -939,7 +939,7 @@ function decideForWrite(context) {
         + '  문서 수정이 목적이라면: 원본을 복사한 뒤(cp) 복사본을 스크립트로 수정하십시오. '
         + `pptx·docx·xlsx 는 ${managedPython()} 에 python-pptx·python-docx·openpyxl 이 설치되어 있고, `
         + '.fig 는 doc2md-fig 의 openfig-core 로 편집·재인코드할 수 있습니다. '
-        + '수정 후 복사본을 `claude-token-saver doc2md <복사본>` 으로 재변환해 의도한 변경이 들어갔는지 확인하십시오. 원본은 절대 직접 수정하지 마십시오.',
+        + '수정 후 복사본을 `sprag doc2md <복사본>` 으로 재변환해 의도한 변경이 들어갔는지 확인하십시오. 원본은 절대 직접 수정하지 마십시오.',
     };
   }
 
@@ -949,7 +949,7 @@ function decideForWrite(context) {
       reason: `[doc2md] ${path.basename(abs)} 는 이진 문서입니다. Edit/Write 는 텍스트를 쓰므로 이 파일을 파괴합니다. `
         + '수정하려면 원본을 복사한 뒤(cp) 복사본을 스크립트로 고치십시오. '
         + `pptx·docx·xlsx 는 ${managedPython()} 의 python-pptx·python-docx·openpyxl, .fig 는 openfig-core 를 쓰고, `
-        + '수정 후 `claude-token-saver doc2md <복사본>` 재변환으로 결과를 검증하십시오.',
+        + '수정 후 `sprag doc2md <복사본>` 재변환으로 결과를 검증하십시오.',
     };
   }
   return null;

package/src/harness-templates.js

@@ -51,7 +51,7 @@ export function harnessClaudeMdBlock(scope = 'project') {
   return `${HARNESS_BLOCK_BEGIN}
 ## 🅷 Harness Rules (claude-token-saver)
 
-이 섹션은 \`claude-token-saver harness init\`이 생성합니다. 5가지 원칙 모두를
+이 섹션은 \`sprag harness init\`이 생성합니다. 5가지 원칙 모두를
 지키면 statusline에 \`🅷 5/5\`로 표시되고, 빠진 게 있으면 \`🅷 3/5\` 식으로
 경고합니다. 수정해도 무방하지만, 섹션 헤더(### 1. ~ ### 5.)는 검출용이므로
 지우지 마세요.
@@ -60,7 +60,7 @@ ${HARNESS_SECTIONS[0].heading}
 - 같은 에러·오해·반복 작업이 한 번 더 발생하면 즉시 \`.claude/ratchet.md\`에
   "조건 → 행동" 한 줄로 룰 추가.
 - claude-token-saver가 후보를 감지하면 statusline에 \`🅷⚠ ratchet?\`로 알림.
-  \`claude-token-saver harness promote "<rule>" --project|--global\`로 승인.
+  \`sprag harness promote "<rule>" --project|--global\`로 승인.
 - **scope는 항상 사용자에게 먼저 물어볼 것** — 프로젝트 한정이면 \`--project\`,
   도구·환경 일반 룰이면 \`--global\`(\`~/.claude/ratchet.md\`). Bash 환경은
   non-TTY라 CLI의 readline 프롬프트가 안 뜨므로, 호출자(LLM)가 직접 묻고
@@ -108,9 +108,9 @@ ${HARNESS_SECTIONS[4].heading}
 ---
 
 📌 운영:
-- \`claude-token-saver harness check\` — 현재 셋업 점수
-- \`claude-token-saver harness promote "<룰>" --project|--global\` — ratchet에 룰 추가 (scope는 사용자에게 먼저 물어볼 것)
-- \`claude-token-saver harness off\` — statusline 표시 끄기
+- \`sprag harness check\` — 현재 셋업 점수
+- \`sprag harness promote "<룰>" --project|--global\` — ratchet에 룰 추가 (scope는 사용자에게 먼저 물어볼 것)
+- \`sprag harness off\` — statusline 표시 끄기
 
 ---
 
@@ -127,13 +127,13 @@ export function harnessRatchetMdInitial() {
 
 같은 실수가 두 번 발생하면 여기에 한 줄 추가됩니다. 형식: "YYYY-MM-DD: <조건> → <행동>".
 
-\`claude-token-saver harness promote "<rule>"\`로 룰을 추가하면 자동으로
+\`sprag harness promote "<rule>"\`로 룰을 추가하면 자동으로
 이 파일에 append 됩니다.
 
 이 파일은 CLAUDE.md의 \`@\` import로 매 세션 로드됩니다 — 즉 여기 있는 모든 줄이
 매 요청마다 토큰을 씁니다. 날짜 뒤에 \`[태그]\`를 붙여두면 나중에 묶어서 정리할 수
 있습니다: \`- 2026-05-08: [video,tts] ...\` →
-\`claude-token-saver harness prune --tag video\` (삭제 아니라 ratchet-archive.md로 이동).
+\`sprag harness prune --tag video\` (삭제 아니라 ratchet-archive.md로 이동).
 
 ## Rules
 

package/src/korean-style.js

@@ -15,7 +15,7 @@
  * Cost: the text is ~1.3k tokens, injected once per session (not per turn) and
  * covered by the prompt cache from the second request on. A token-saving tool
  * has no business spending that silently, so the feature is opt-in via
- * `claude-token-saver korean on`.
+ * `sprag korean on`.
  *
  * The guidance itself is vendored from fluent-korean
  * (https://github.com/snflkd/fluent-korean), Copyright (c) 2026 snflkd, MIT
@@ -176,7 +176,7 @@ export function koreanStyleInjection({ cfg = loadConfig() } = {}) {
   const text = koreanStyleText();
   if (!text) return null;
   return [
-    '[claude-token-saver korean-style] 이 세션에서 한국어를 출력할 때는 아래 지침을 따르십시오.',
+    '[sprag korean-style] 이 세션에서 한국어를 출력할 때는 아래 지침을 따르십시오.',
     '이 지침은 사용자가 claude-token-saver에 설정한 것입니다.',
     ...koreanScopeLines(cfg),
     '표기 규칙(예외 없이 적용): 도구 호출 인자에 한국어를 비롯한 비ASCII 문자열을 담을 때에는 반드시 리터럴 UTF-8로 작성하고, \\uXXXX 유니코드 이스케이프로는 절대 작성하지 마십시오. 이스케이프로 작성하면 글자가 깨진 채 파일에 기록되는 사례가 자주 발생합니다.',

package/src/model-rules.js

@@ -201,7 +201,7 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     '# Model-Fitting Ratchet (claude-token-saver 자동 관리)',
     '',
     '로그 기반 티어 위임 룰. 이 파일은 route-scan이 매 스캔마다 통째로 재생성하므로',
-    '직접 수정하지 마세요 — 목록/제거: `claude-token-saver route-scan rules [rm <N>]`.',
+    '직접 수정하지 마세요 — 목록/제거: `sprag route-scan rules [rm <N>]`.',
     '',
     '**사용자는 아래 룰에 해당하는 서브에이전트 위임을 이미 승인했습니다.**',
     '룰에 들어맞는 요청이면 되묻지 말고 바로 위임하십시오. "사용자가 명시적으로',
@@ -212,7 +212,7 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     '',
     '위임을 실행할 때는 사용자에게 다음 한 줄을 먼저 표시할 것',
     '(어떤 도구가 토큰을 아끼고 있는지 가시화):',
-    '`🔀 [claude-token-saver] 모델 피팅: "<유형>" → <agent> 위임`',
+    '`🔀 [sprag] 모델 피팅: "<유형>" → <agent> 위임`',
     '',
     '## 티어 판별 기준 (모든 룰에 공통 적용)',
     '',
@@ -249,7 +249,7 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     '',
     'Log-derived tier delegation rules. route-scan regenerates this file in full',
     'on every scan — do not edit it by hand. List / remove with:',
-    '`claude-token-saver route-scan rules [rm <N>]`.',
+    '`sprag route-scan rules [rm <N>]`.',
     '',
     '**The user has already approved the subagent delegations described below.**',
     'When a request matches a rule, delegate right away instead of asking. If a',
@@ -260,7 +260,7 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     '',
     'When delegating under a rule below, show the user this line first so it is',
     'visible which tool is saving tokens:',
-    '`🔀 [claude-token-saver] model fitting: "<category>" → delegated to <agent>`',
+    '`🔀 [sprag] model fitting: "<category>" → delegated to <agent>`',
     '',
     '## Tier criteria (apply to every rule below)',
     '',

package/src/update-check.js

@@ -23,7 +23,10 @@ import { fileURLToPath } from 'node:url';
 import { userDataDir } from './paths.js';
 import { debug } from './debug.js';
 
-const PKG_NAME = 'claude-token-saver';
+// Whichever name this copy was installed under (sprag-cli or the legacy
+// claude-token-saver) is the one whose registry entry must be consulted.
+import { createRequire } from 'node:module';
+const PKG_NAME = createRequire(import.meta.url)('../package.json').name;
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24h — the registry is not a health endpoint
 const FETCH_TIMEOUT_MS = 5000;