claude-token-saver 2.0.1 → 2.0.3

package/README.md

@@ -1,6 +1,6 @@
 # claude-token-saver
 
-> **Renamed from `claude-cache-monitor` in v2.0.** The old name still works — `npm i claude-cache-monitor` now redirects here, and the `claude-cache-monitor` binary remains available as an alias. See [migration notes](#migration-from-claude-cache-monitor).
+> **Renamed from `claude-cache-monitor` in v2.0.** The old npm package is deprecated and points here. The `claude-cache-monitor` binary is gone — use `claude-token-saver` instead. See [migration notes](#migration-from-claude-cache-monitor).
 
 > 📺 **HNPulse Shorts** — 이 도구가 만들어진 배경 (캐시 TTL 1h→5m 변경 이슈):
 > **[▶ Watch the Short](https://www.youtube.com/shorts/oSx2sg935nI)** · [All HNPulse Shorts](https://www.youtube.com/@HNPulseKR/shorts)
@@ -9,7 +9,7 @@
 
 **Save tokens on Claude Code.** Catch the session that suddenly burned 10× your usual input, figure out *why*, and get a one-line remediation you can paste.
 
-v1.5 adds three things on top of the original cache monitor:
+v1.5 adds three things on top of the original `claude-cache-monitor`:
 - **Spike diagnosis** — detect recent sessions whose input tokens exploded vs. your own baseline, and name the cause (1M context, 5m TTL churn, cache rebuild, chatty output).
 - **1M-context detection** — Opus 4.7+ auto-enables 1M context on Max plans, silently. This tool surfaces it on the statusline as `Ctx 1M` (red) vs. `Ctx 200k` (green), with the OS-specific command to turn it off.
 - **Actionable advice** — OS-aware remediation (`~/.zshrc` vs. `setx`) and the warning for the known `/model` toggle bug ([anthropics/claude-code#31640](https://github.com/anthropics/claude-code/issues/31640)).
@@ -47,6 +47,12 @@ npx claude-token-saver --format json
 npx claude-token-saver --format csv
 ```
 
+> **Upgrading from `claude-cache-monitor`?** Uninstall the old package first, then install the new one and update your settings command name:
+> ```bash
+> npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
+> ```
+> After upgrading, change any `claude-cache-monitor …` invocations (including `statusLine.command` in `~/.claude/settings.json`) to `claude-token-saver …`. See [Migration](#migration-from-claude-cache-monitor).
+
 ## Spike Diagnosis (new in v1.5.0)
 
 When you run `npx claude-token-saver`, sessions from the last 24 hours whose total input tokens are **≥ 3× your p95 baseline** (or whose single-request context exceeds 250k, indicating 1M context) appear at the top of the report with root causes and remediation commands. Example output:
@@ -158,7 +164,7 @@ The Claude Code statusline is event-driven — it only re-renders on assistant m
 }
 ```
 
-Or combine with an existing statusline script — see [`examples/statusline-command.sh`](examples/statusline-command.sh) for a drop-in that prints `user@host:cwd | <cache monitor>`.
+Or combine with an existing statusline script — see [`examples/statusline-command.sh`](examples/statusline-command.sh) for a drop-in that prints `user@host:cwd | <token-saver segment>`.
 
 #### Windows (native PowerShell, not WSL)
 
@@ -230,9 +236,13 @@ When the hook is installed:
 ## Output Example
 
 ```
-  Claude Cache Monitor — Last 30 days
+  Claude 토큰 아껴쓰기 — Last 30 days
+  (claude-token-saver v2.0.1)
   ══════════════════════════════════════════════════
 
+  Context window: 200k  ✓ 200k 컨텍스트 (표준)
+  (최근 단일 요청 최대 83k 토큰)
+
   Summary
   Sessions: 380  |  API calls: 10,813  |  Model: claude-opus-new
   Cache hit rate: 98.2%  |  Total input: 1957.94M tokens
@@ -338,24 +348,52 @@ Zero dependencies.
 
 ## Migration from claude-cache-monitor
 
-v2.0 renamed the package to reflect the expanded scope (spike diagnosis + 1M-context detection + remediation, not just cache monitoring). **No action required** in most cases:
+v2.0 renamed the package to reflect the expanded scope (spike diagnosis + 1M-context detection + remediation, not just cache monitoring).
+
+### New users
+
+```bash
+npm i -g claude-token-saver
+# or, no install:
+npx claude-token-saver
+```
+
+Skip the rest of this section.
 
-- `npm i claude-cache-monitor` still installs — the old package is deprecated and redirects here.
-- The binary `claude-cache-monitor` still works alongside the new `claude-token-saver` (both map to the same entry point).
-- Your existing `statusLine.command` setting in `~/.claude/settings.json` keeps working.
+### Upgrading from `claude-cache-monitor` v1.x
 
-If you want to update:
+Two steps:
 
 ```bash
+# 1. Remove the old package (its claude-cache-monitor bin is now obsolete).
 npm uninstall -g claude-cache-monitor
+
+# 2. Install the new one.
 npm i -g claude-token-saver
+```
+
+Then update any `claude-cache-monitor …` references. The main one is `statusLine.command` in `~/.claude/settings.json`:
+
+```jsonc
+// before
+"command": "claude-cache-monitor --statusline --icon"
+
+// after
+"command": "claude-token-saver --statusline --icon"
+```
 
-# then in ~/.claude/settings.json, change:
-#   "command": "claude-cache-monitor --statusline --icon"
-# to:
-#   "command": "claude-token-saver --statusline --icon"
+### Why we dropped the `claude-cache-monitor` bin alias
+
+Earlier v2.0 releases shipped a `claude-cache-monitor` bin alongside `claude-token-saver` so existing settings would keep working without edits. In practice this caused an `EEXIST: file already exists` error on `npm i -g claude-token-saver` when v1.x was still installed — and that collision forced the uninstall step anyway. Dropping the alias makes the upgrade path a clean two-liner and lets `npm i -g claude-token-saver` succeed directly if you've never installed the old one.
+
+### Zero-install (npx)
+
+```bash
+npx claude-token-saver@latest --statusline --icon
 ```
 
+No uninstall needed; npm just fetches the new name.
+
 ## License
 
 MIT

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "claude-token-saver",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
   "type": "module",
   "bin": {
-    "claude-token-saver": "./bin/cli.js",
-    "claude-cache-monitor": "./bin/cli.js"
+    "claude-token-saver": "./bin/cli.js"
   },
   "files": [
     "bin/",