claude-token-saver 2.8.5 → 2.9.0

package/README.en.md

@@ -13,40 +13,38 @@ A CLI to **diagnose and save tokens on Claude Code**. Cache hit rate, TTL countd
 ## Install
 
 ```bash
-# 1. (existing users) remove the old package
+# (existing users) remove the old package
 npm uninstall -g claude-cache-monitor
 
-# 2. install
+# install — the postinstall hook auto-registers the Skill and statusline
 npm i -g claude-token-saver
-
-# 3. wire into Claude Code (Skill + statusline guidance)
-claude-token-saver install
 ```
 
 Or run once with no install: `npx claude-token-saver`.
 
-## What you see after install
+If postinstall was skipped (e.g. `--ignore-scripts`, sudo, or sandboxed installs), register manually:
+
+```bash
+claude-token-saver install
+```
+
+## Claude Code statusline
 
-**(A) One-shot report** — `claude-token-saver`:
+After install, Claude Code's bottom statusline updates every 5 seconds with cache state (postinstall registers it in `~/.claude/settings.json` automatically).
 
 ```
-Claude token saver — Last 30 days
-Context window: 200k  ✓ standard
-Cache hit rate: 98.2%  |  Total input: 1957.94M tokens
-TTL Breakdown / Cost Impact / Daily Trend ...
+🤖 Opus 4.7 · 🧠 Cache hit 98.0% · ⏳ Cache expires 59:51 · 📦 Ctx 200k · 💰 Cache saved $221 · last 1d
 ```
 
-If a session spiked, a `⚠ Spike detected` block leads the report with root cause + a paste-ready remediation command.
-
-**(B) Statusline chip** — once wired into `~/.claude/settings.json`:
+Risk chips lead when something's wrong:
 
 ```
-🧠 97.5% · ⏳ 1h 42:15 · 💰 $4.8K · 🤖 Opus 4.7 · ✦ 5H 47% · 📅 7D 9%
+🚨 5H 94% (resets in 12m) · 🤖 Opus 4.7 · 🧠 Cache hit 72.1% · ⚠ Cache miss · 📦 Ctx 200k · last 1d
 ```
 
-Risk chips lead when something's wrong: `🚨 5H 94%`, `⚠ 1M ON`, `⚠ Cache miss`, `⚠ 5m TTL`.
+Risk chips: `🚨 5H/7D NN%`, `⚠ 1M ON`, `⚠ Input spike`, `⚠ Cache miss`, `⚠ 5m TTL`, `⚠ Rebuild churn`, `⚠ Output heavy`, `⚠ Call surge`.
 
-## Wire up the statusline
+If postinstall was skipped (you already use a different statusline, etc.), wire it manually:
 
 ```json
 {
@@ -58,19 +56,50 @@ Risk chips lead when something's wrong: `🚨 5H 94%`, `⚠ 1M ON`, `⚠ Cache m
 }
 ```
 
-`refreshInterval: 5` keeps the TTL countdown ticking while idle (Claude Code's statusline is otherwise event-driven). 1s also works, but 5s is the recommended default to avoid constant I/O. For Windows PowerShell, see `examples/statusline-command.ps1`.
+`refreshInterval: 5` keeps the TTL countdown ticking while idle. For Windows PowerShell see `examples/statusline-command.ps1`.
+
+## Skill — mention a chip, it activates
+
+The Claude Code Skill registered at install time auto-activates whenever you mention chip wording in chat ("cache hit rate", "1M context", "5H cap"). It runs `claude-token-saver last` to surface the most recent warning + remediation, then points you at `history` / `handoff` for follow-up. (v2.6.0 folded the legacy `/token-monitor` slash command into this Skill — older installs are cleaned up automatically the next time you run `claude-token-saver install`.)
+
+## One-shot report
+
+Run `claude-token-saver` for the last-day diagnostic table:
+
+```
+  Claude Token Saver — Last 1 day
+  (claude-token-saver v2.9.0)
+  ══════════════════════════════════════════════════
+
+  Context window: 200k  ✓ 200k context (standard)
+  Sessions: 11  |  API calls: 578  |  Cache hit rate: 98.0%
+  TTL Breakdown / Cost Impact / Daily Trend …
+```
+
+If a session spiked, a `⚠ Spike detected` block leads the report with the root-cause code (table below) and an OS-aware remediation command.
+
+## Output language
+
+`last` / `history` / advice messages render in one language at a time (statusline chips stay symbolic). English is the default — switch via:
+
+```bash
+claude-token-saver mode ko    # or: claude-token-saver mode lang=ko
+claude-token-saver mode en    # back to English
+claude-token-saver mode       # show current settings
+```
 
 ## Commands
 
 | Command | What it does |
 |---|---|
-| `claude-token-saver` | Last 30 days diagnostic report |
-| `claude-token-saver --days 7` | Change window |
-| `claude-token-saver --statusline --icon` | One-line statusline output |
-| `claude-token-saver install` | Register Claude Code Skill (auto-activates on chip wording) |
+| `claude-token-saver` | Last-1-day diagnostic report (`--days N` to change window) |
+| `claude-token-saver last` | Most recent warning + remediation (the command the Skill invokes) |
 | `claude-token-saver history` | Last 7 days of chip transitions (1M ON, Cache miss, cap, …) |
 | `claude-token-saver handoff` | Back current work up to `HANDOFF-YYYY-MM-DD-HHMM.md` before a cap blocks you |
-| `claude-token-saver --install-hook` | Auto-log cache stats on every tool call |
+| `claude-token-saver mode [keywords...]` | Configure output (`icon`/`text`, `en`/`ko`, `verbose`, `1d`/`7d`, …) |
+| `claude-token-saver --statusline --icon` | One-line statusline output (called by Claude Code) |
+| `claude-token-saver install` | Manually register Skill + statusline (postinstall fallback) |
+| `claude-token-saver --install-hook` | Optionally auto-log cache stats on every tool call |
 
 ## Options
 
@@ -147,6 +176,21 @@ Node.js ≥ 18 · macOS / Windows / Linux / WSL · zero dependencies.
 
 **IntelliJ Claude Code plugin** — the statusline widget fuses prior and current frames at the character level when emoji are in the output, producing artifacts like `Cache expires 59:548`. v2.8.5+ detects `TERMINAL_EMULATOR=JetBrains-JediTerm` and falls back to text mode automatically (`--icon` is also ignored under IntelliJ). Other terminals (iTerm, Terminal, WSL, etc.) are unaffected.
 
+## Release notes
+
+### v2.9.0 (2026-04-27)
+- **Output language is now configurable.** `last` / `history` / advice render in a single language at a time. English by default; switch with `claude-token-saver mode ko`. Statusline chips remain symbolic.
+- History files stay bilingual on disk; the language toggle is applied at display time.
+
+### v2.8.6 (2026-04-27)
+- **Skill auto-registers on install.** A `postinstall` hook wires the Claude Code Skill and statusline into `~/.claude` automatically — no second command. `claude-token-saver install` still works as a fallback for `--ignore-scripts` / sudo / sandboxed environments.
+- README polish in both languages; corrected the `claude-cache-monitor` alias-removal note (timing was reversed).
+
+### v2.8.5
+- IntelliJ Claude Code plugin: auto-fall back to text mode when `TERMINAL_EMULATOR=JetBrains-JediTerm` to avoid frame-fusion artefacts.
+
+Older versions: see `git log`.
+
 ## License
 
 MIT

package/README.md

@@ -2,7 +2,7 @@
 
 # claude-token-saver
 
-> v2.0에서 `claude-cache-monitor` → `claude-token-saver`로 이름이 바뀌었습니다. 기존 사용자는 [마이그레이션](#마이그레이션-claude-cache-monitor에서) 참고.
+> v2.0에서 `claude-cache-monitor` → `claude-token-saver`로 이름이 바뀌었습니다. 기존 사용자는 아래 [마이그레이션](#마이그레이션-claude-cache-monitor에서) 항목을 참고하세요.
 
 Claude Code의 **토큰 사용량을 진단·절약**하는 CLI. 캐시 히트율, TTL 카운트다운, 1M 컨텍스트 감지, 5h/7d 한도 경고를 statusline 한 줄로 보여줍니다.
 
@@ -13,40 +13,38 @@ Claude Code의 **토큰 사용량을 진단·절약**하는 CLI. 캐시 히트
 ## 설치
 
 ```bash
-# 1. (기존 사용자) 구 패키지 제거
+# (기존 사용자) 구 패키지 제거
 npm uninstall -g claude-cache-monitor
 
-# 2. 설치
+# 설치 — postinstall 훅이 Skill과 statusline을 자동 등록합니다
 npm i -g claude-token-saver
-
-# 3. Claude Code 통합 (Skill + statusline 안내)
-claude-token-saver install
 ```
 
 설치 없이 한 번만 실행하려면 `npx claude-token-saver`.
 
-## 설치 후 보이는 것
+`--ignore-scripts`나 sudo 등으로 postinstall이 실행되지 않은 환경에서는 다음 명령으로 수동 등록할 수 있습니다.
+
+```bash
+claude-token-saver install
+```
+
+## Claude Code statusline
 
-**(A) 단발 리포트** — `claude-token-saver` 실행 시:
+설치 후 Claude Code 하단 statusline에 캐시 상태가 5초마다 갱신됩니다 (postinstall이 `~/.claude/settings.json`에 자동 등록).
 
 ```
-Claude 토큰 아껴쓰기 — Last 30 days
-Context window: 200k  ✓ 표준
-Cache hit rate: 98.2%  |  Total input: 1957.94M tokens
-TTL Breakdown / Cost Impact / Daily Trend ...
+🤖 Opus 4.7 · 🧠 Cache hit 98.0% · ⏳ Cache expires 59:51 · 📦 Ctx 200k · 💰 Cache saved $221 · last 1d
 ```
 
-급증 세션이 있으면 상단에 `⚠ 토큰 급증 감지` 블록과 원인·해결 명령이 함께 출력됩니다.
-
-**(B) statusline 한 줄** — `~/.claude/settings.json`에 등록 시:
+위험 상황에서는 경고 칩이 맨 앞으로 나옵니다.
 
 ```
-🧠 97.5% · ⏳ 1h 42:15 · 💰 $4.8K · 🤖 Opus 4.7 · ✦ 5H 47% · 📅 7D 9%
+🚨 5H 94% (resets in 12m) · 🤖 Opus 4.7 · 🧠 Cache hit 72.1% · ⚠ Cache miss · 📦 Ctx 200k · last 1d
 ```
 
-위험 상황에서는 칩이 앞으로 튀어나옵니다 — `🚨 5H 94%`, `⚠ 1M ON`, `⚠ Cache miss`, `⚠ 5m TTL` 등.
+표시되는 경고 칩 — `🚨 5H/7D NN%`, `⚠ 1M ON`, `⚠ Input spike`, `⚠ Cache miss`, `⚠ 5m TTL`, `⚠ Rebuild churn`, `⚠ Output heavy`, `⚠ Call surge`.
 
-## statusline 등록
+수동 등록이 필요한 경우(다른 statusline을 이미 쓰고 있어 postinstall이 건너뛴 경우 등):
 
 ```json
 {
@@ -58,30 +56,61 @@ TTL Breakdown / Cost Impact / Daily Trend ...
 }
 ```
 
-`refreshInterval: 5`는 TTL 카운트다운이 idle 상태에서도 5초마다 갱신되게 합니다 (1초도 가능하지만 상시 I/O 부담을 피하려고 5초를 기본값으로 권장). Windows(PowerShell)는 `examples/statusline-command.ps1` 참고.
+`refreshInterval: 5`는 idle 상태에서도 TTL 카운트다운을 5초마다 갱신합니다. Windows(PowerShell)는 `examples/statusline-command.ps1` 참고.
+
+## Skill — 칩을 언급하면 자동 활성화
+
+설치 시 함께 등록되는 Claude Code Skill 덕분에 대화 중 "cache hit rate", "1M context", "5H cap" 같은 칩 단어를 언급하면 Claude가 자동으로 `claude-token-saver last`를 실행해 가장 최근 경고와 처방을 보여주고, 필요 시 `history` / `handoff`로 후속 조치를 안내합니다. (v2.6.0에서 레거시 `/token-monitor` 슬래시 커맨드는 Skill로 흡수됐습니다 — 이전 버전 사용자는 `claude-token-saver install`을 한 번 다시 실행하면 자동 정리됩니다.)
+
+## 단발 리포트
+
+`claude-token-saver`를 실행하면 최근 1일 진단 표가 출력됩니다.
+
+```
+  Claude Token Saver — Last 1 day
+  (claude-token-saver v2.9.0)
+  ══════════════════════════════════════════════════
+
+  Context window: 200k  ✓ 200k context (standard)
+  Sessions: 11  |  API calls: 578  |  Cache hit rate: 98.0%
+  TTL Breakdown / Cost Impact / Daily Trend …
+```
+
+급증 세션이 있으면 상단에 `⚠ Spike detected` 블록과 원인 코드(아래 표) · OS별 해결 명령이 함께 출력됩니다.
+
+## 출력 언어 전환
+
+`last` / `history` / 처방 메시지는 영어가 기본값이며 한 번에 한 언어만 출력합니다 (statusline 칩은 항상 동일한 기호 형식). 한국어로 바꾸려면:
+
+```bash
+claude-token-saver mode ko    # 또는: claude-token-saver mode lang=ko
+claude-token-saver mode en    # 영어로 복귀
+claude-token-saver mode       # 현재 설정 확인
+```
 
 ## 주요 명령
 
 | 명령 | 설명 |
 |---|---|
-| `claude-token-saver` | 최근 30일 진단 리포트 |
-| `claude-token-saver --days 7` | 기간 변경 |
-| `claude-token-saver --statusline --icon` | statusline용 한 줄 |
-| `claude-token-saver install` | Claude Code Skill 자동 등록 (칩 단어 언급 시 자동 활성) |
+| `claude-token-saver` | 최근 1일 진단 리포트 (`--days N`로 기간 변경) |
+| `claude-token-saver last` | 가장 최근 경고 1건 + 처방 (Skill이 호출하는 명령) |
 | `claude-token-saver history` | 최근 7일간 칩 전이 로그 (1M ON, Cache miss, cap 등) |
 | `claude-token-saver handoff` | 현재 작업을 `HANDOFF-YYYY-MM-DD-HHMM.md`로 백업 (cap 임박 시) |
-| `claude-token-saver --install-hook` | 매 도구 호출마다 캐시 통계 자동 로깅 |
+| `claude-token-saver mode [keywords...]` | 출력 모드 설정 (`icon`/`text`, `ko`/`en`, `verbose`, `1d`/`7d` 등) |
+| `claude-token-saver --statusline --icon` | statusline용 한 줄 출력 (Claude Code가 호출) |
+| `claude-token-saver install` | Skill·statusline 수동 등록 (postinstall이 막힌 환경) |
+| `claude-token-saver --install-hook` | 매 도구 호출마다 캐시 통계 자동 로깅 (선택) |
 
 전체 옵션은 `--help` 또는 [영문 README](./README.en.md#options).
 
-## 진단되는 급증 원인
+## 토큰 급증 원인 코드
 
 | 코드 | 의미 |
 |---|---|
 | `LARGE_INPUT_PER_REQUEST` | 단일 요청 250k+ → 1M 컨텍스트 의심 |
-| `LOW_HIT_RATE` | 캐시 히트율 < 50% |
-| `BUCKET_5M_DOMINANT` | 캐시 쓰기의 70%+가 5분 버킷 (Pro 플랜 또는 Max 다운그레이드) |
-| `HIGH_OUTPUT_RATIO` | 출력/입력 > 0.15 (출력은 입력의 5배 가격) |
+| `LOW_HIT_RATE` | 캐시 히트율 50% 미만 |
+| `BUCKET_5M_DOMINANT` | 캐시 쓰기의 70% 이상이 5분 버킷에 집중 (Pro 플랜 또는 Max 다운그레이드) |
+| `HIGH_OUTPUT_RATIO` | 출력/입력 비율 0.15 초과 (출력 단가가 입력의 5배) |
 | `FREQUENT_CACHE_REBUILD` | 캐시 재작성이 읽기보다 많음 |
 
 각 코드마다 OS별 해결 명령(`~/.zshrc` / `setx`)이 함께 출력됩니다.
@@ -93,11 +122,11 @@ npm uninstall -g claude-cache-monitor
 npm i -g claude-token-saver
 ```
 
-`~/.claude/settings.json`의 `statusLine.command`를 `claude-cache-monitor …` → `claude-token-saver …`로 교체하세요. v2.0 이전의 `claude-cache-monitor` 바이너리 별칭은 npm 충돌(EEXIST) 때문에 제거됐습니다.
+`~/.claude/settings.json`의 `statusLine.command`를 `claude-cache-monitor …` → `claude-token-saver …`로 교체하세요. v2.0에 잠시 제공됐던 `claude-cache-monitor` 바이너리 별칭은 글로벌 설치 시 npm 충돌(EEXIST)을 일으켜 이후 버전에서 제거됐습니다.
 
 ## 동작 원리
 
-Claude Code는 모든 API 응답을 `~/.claude/projects/<dir>/<session>.jsonl`에 기록합니다. 이 도구는 `cache_read_input_tokens`, `cache_creation.ephemeral_5m/1h_input_tokens` 등을 `requestId`로 중복 제거 후 일·세션 단위로 집계합니다.
+Claude Code는 모든 API 응답을 `~/.claude/projects/<dir>/<session>.jsonl`에 기록합니다. 이 도구는 `cache_read_input_tokens`, `cache_creation.ephemeral_5m/1h_input_tokens` 같은 필드를 `requestId` 기준으로 중복 제거한 뒤 일·세션 단위로 집계합니다.
 
 ## 환경
 
@@ -105,7 +134,22 @@ Node.js ≥ 18 · macOS / Linux / Windows / WSL · 의존성 0.
 
 ## 알려진 환경 이슈
 
-**IntelliJ Claude Code plugin** — statusline 위젯이 이전 프레임과 새 프레임을 글자 단위로 잘못 합쳐 `Cache expires 59:548` 같은 합성 잔재가 보이는 버그가 있습니다 (이모지가 들어간 텍스트일 때만). v2.8.5+에서는 `TERMINAL_EMULATOR=JetBrains-JediTerm`을 감지하면 자동으로 text 모드로 폴백해 이모지 없이 출력합니다 (`--icon` 플래그도 IntelliJ에서는 무시). 다른 터미널(iTerm, Terminal, WSL 등)에는 영향 없습니다.
+**IntelliJ Claude Code plugin** — statusline 위젯이 이전 프레임과 새 프레임을 글자 단위로 잘못 합쳐 `Cache expires 59:548` 같은 잔재 문자열이 보이는 버그가 있습니다 (이모지가 포함된 출력에서만 재현). v2.8.5+는 `TERMINAL_EMULATOR=JetBrains-JediTerm`을 감지하면 자동으로 text 모드로 폴백해 이모지 없이 출력합니다 (`--icon` 플래그도 IntelliJ에서는 무시됩니다). 다른 터미널(iTerm, Terminal, WSL 등)에는 영향 없습니다.
+
+## 릴리스 노트
+
+### v2.9.0 (2026-04-27)
+- **출력 언어 전환 추가** — `last` / `history` / 처방 메시지가 한 번에 한 언어만 출력합니다. 기본은 영어, `claude-token-saver mode ko`로 한국어 전환 (statusline 칩은 영향 없음).
+- 기존 history 파일은 이중언어로 보관되며, 표시할 때 선택한 언어만 필터링됩니다.
+
+### v2.8.6 (2026-04-27)
+- **Skill 자동 등록** — `npm i -g claude-token-saver` 시 postinstall 훅이 Skill과 statusline을 자동으로 `~/.claude`에 등록. 수동 `claude-token-saver install`은 `--ignore-scripts` / sudo 환경용 폴백으로 유지.
+- 한·영 README 문장 다듬기, `claude-cache-monitor` alias 제거 시점 설명 정정.
+
+### v2.8.5
+- IntelliJ Claude Code plugin에서 statusline 프레임 합성 버그 회피 — `TERMINAL_EMULATOR=JetBrains-JediTerm` 감지 시 자동 text 모드.
+
+이전 버전은 `git log`를 참고하세요.
 
 ## 라이선스
 

package/bin/cli.js

@@ -230,6 +230,8 @@ async function main() {
   if (args[0] === 'last') {
     const { readRecent, historyDir } = await import('../src/history.js');
     const { ISSUE_MESSAGES, CHIP_TO_CODES, CAP_TIPS } = await import('../src/advice.js');
+    const { userLanguage } = await import('../src/config.js');
+    const lang = userLanguage();
     const days = parseFloat(getArg('--days') || '1');
     const recent = readRecent(days);
     const latest = findLatestWarning(recent, CHIP_TO_CODES);
@@ -247,10 +249,9 @@ async function main() {
     if (latest.isCap) {
       if (latest.capReset) console.log(`  Cap window: ${latest.capReset}`);
       console.log('');
-      console.log('💡 ' + CAP_TIPS.en);
-      console.log('💡 ' + CAP_TIPS.ko);
+      console.log('💡 ' + (lang === 'ko' ? CAP_TIPS.ko : CAP_TIPS.en));
       console.log('');
-      console.log('Run:');
+      console.log(lang === 'ko' ? '실행:' : 'Run:');
       console.log('  claude-token-saver handoff');
       return;
     }
@@ -258,31 +259,29 @@ async function main() {
     // bilingual (English first, `└ Korean` continuation per line — matches
     // the history.md format).
     if (latest.codes.length === 0) {
-      console.log('(No diagnostic code attached — open the table view: `claude-token-saver --days 1`)');
-      console.log('(진단 코드 없음 — 표 뷰를 열어보세요: `claude-token-saver --days 1`)');
+      console.log(lang === 'ko'
+        ? '(진단 코드 없음 — 표 뷰를 열어보세요: `claude-token-saver --days 1`)'
+        : '(No diagnostic code attached — open the table view: `claude-token-saver --days 1`)');
       return;
     }
+    // Pick a single language per field; fall back to EN when KO is missing.
+    const pick = (en, ko) => (lang === 'ko' && ko ? ko : en);
     for (const code of latest.codes) {
       const msg = ISSUE_MESSAGES[code];
       if (!msg) {
         console.log(`Code: ${code} (no advice registered)`);
         continue;
       }
-      console.log(`▎ ${msg.title}`);
-      if (msg.titleKo && msg.titleKo !== msg.title) console.log(`  └ ${msg.titleKo}`);
-      console.log(`  ${msg.explain}`);
-      if (msg.explainKo && msg.explainKo !== msg.explain) console.log(`  └ ${msg.explainKo}`);
+      console.log(`▎ ${pick(msg.title, msg.titleKo)}`);
+      console.log(`  ${pick(msg.explain, msg.explainKo)}`);
       const actions = typeof msg.actions === 'function' ? msg.actions() : msg.actions || [];
       for (const a of actions) {
         console.log('');
-        console.log(`  ${a.label}:`);
-        if (a.labelKo && a.labelKo !== a.label) console.log(`  └ ${a.labelKo}:`);
+        console.log(`  ${pick(a.label, a.labelKo)}:`);
         const cmds = a.commands || [];
         const cmdsKo = a.commandsKo || [];
         for (let i = 0; i < cmds.length; i++) {
-          console.log(`    - ${cmds[i]}`);
-          const ko = cmdsKo[i];
-          if (ko && ko !== cmds[i]) console.log(`      └ ${ko}`);
+          console.log(`    - ${pick(cmds[i], cmdsKo[i])}`);
         }
       }
       console.log('');
@@ -297,7 +296,10 @@ async function main() {
   //   claude-token-saver history --days 30    # custom window
   //   claude-token-saver history --list       # just list available dates
   if (args[0] === 'history') {
-    const { readRecent, listDates, historyDir } = await import('../src/history.js');
+    const { readRecent, listDates, historyDir, formatHistoryForLanguage } =
+      await import('../src/history.js');
+    const { userLanguage } = await import('../src/config.js');
+    const lang = userLanguage();
     if (hasFlag('--list')) {
       const dates = listDates();
       if (dates.length === 0) {
@@ -316,7 +318,8 @@ async function main() {
       return;
     }
     for (const { content } of recent) {
-      console.log(content.replace(/\n+$/, ''));
+      const filtered = formatHistoryForLanguage(content, lang);
+      console.log(filtered.replace(/\n+$/, ''));
       console.log('');
     }
     return;
@@ -400,11 +403,12 @@ async function main() {
       const eff = statuslineDefaults();
       const raw = loadConfig().statusline || {};
       console.log('Statusline mode (effective):');
-      console.log(`  icon:    ${eff.icon}`);
-      console.log(`  verbose: ${eff.verbose}`);
-      console.log(`  timer:   ${eff.timer}`);
-      console.log(`  color:   ${eff.color}`);
-      console.log(`  window:  ${eff.windowLabel} (${eff.windowHours}h)`);
+      console.log(`  icon:     ${eff.icon}`);
+      console.log(`  verbose:  ${eff.verbose}`);
+      console.log(`  timer:    ${eff.timer}`);
+      console.log(`  color:    ${eff.color}`);
+      console.log(`  language: ${eff.language}  (advice / history / last)`);
+      console.log(`  window:   ${eff.windowLabel} (${eff.windowHours}h)`);
       console.log('');
       console.log(`Stored config (${configPath()}):`);
       console.log(`  ${Object.keys(raw).length === 0 ? '(none — using defaults)' : JSON.stringify(raw)}`);
@@ -421,7 +425,7 @@ async function main() {
     }
     const eff = statuslineDefaults();
     console.log(`Updated: ${applied.join(', ')}`);
-    console.log(`Now: icon=${eff.icon} verbose=${eff.verbose} timer=${eff.timer} color=${eff.color} window=${eff.windowLabel}`);
+    console.log(`Now: icon=${eff.icon} verbose=${eff.verbose} timer=${eff.timer} color=${eff.color} language=${eff.language} window=${eff.windowLabel}`);
     console.log('Statusline picks up the change on the next refresh (~1s).');
     return;
   }

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "claude-token-saver",
-  "version": "2.8.5",
+  "version": "2.9.0",
   "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"
   },
+  "scripts": {
+    "postinstall": "node bin/cli.js install || true"
+  },
   "files": [
     "bin/",
     "src/",

package/src/config.js

@@ -45,6 +45,12 @@ const KEYWORDS = {
   'no-timer': { key: 'timer',   value: false },
   color:      { key: 'color',   value: true  },
   'no-color': { key: 'color',   value: false },
+  // Language for advice / history / `last` output. Default is `en`.
+  // Statusline chips themselves stay symbolic (e.g. `🚨 5H 94%`) regardless.
+  en:         { key: 'language', value: 'en' },
+  english:    { key: 'language', value: 'en' },
+  ko:         { key: 'language', value: 'ko' },
+  korean:     { key: 'language', value: 'ko' },
 };
 
 // Window preset accepts forms like:
@@ -68,6 +74,7 @@ function parseWindow(word) {
 export const VALID_KEYWORDS = Object.keys(KEYWORDS).concat([
   '<N>h (e.g. 1h, 6h, 24h)',
   '<N>d (e.g. 1d, 7d, 30d)',
+  'lang=en | lang=ko',
   'reset',
   'default',
 ]);
@@ -90,6 +97,13 @@ export function applyMode(words) {
       applied.push(lower);
       continue;
     }
+    const langMatch = lower.match(/^lang(?:uage)?=(en|english|ko|korean)$/);
+    if (langMatch) {
+      const v = langMatch[1].startsWith('k') ? 'ko' : 'en';
+      cfg.statusline.language = v;
+      applied.push(`lang=${v}`);
+      continue;
+    }
     const hours = parseWindow(lower);
     if (hours !== null && hours > 0) {
       cfg.statusline.windowHours = hours;
@@ -136,11 +150,19 @@ export function statuslineDefaults() {
     verbose:     s.verbose !== false,
     timer:       s.timer   !== false,
     color:       s.color   !== false,
+    language:    s.language === 'ko' ? 'ko' : 'en',
     windowHours,
     windowLabel: formatWindow(windowHours),
   };
 }
 
+// Resolve the user's preferred output language for advice/history/last.
+// Returns 'en' or 'ko'; defaults to 'en' for first-time users.
+export function userLanguage() {
+  const s = loadConfig().statusline || {};
+  return s.language === 'ko' ? 'ko' : 'en';
+}
+
 /**
  * Render hours as the most natural unit:
  *   24h → "1d", 168h → "7d", 6h → "6h", 36h → "36h" (not whole days).

package/src/history.js

@@ -151,7 +151,9 @@ function tipsForEvent(chip, detail) {
     const tip = ISSUE_TIPS[code];
     if (!tip) continue;
     enLines.push(`  💡 ${tip.en}`);
-    koLines.push(`  💡 ${tip.ko}`);
+    // KR tip carries the `└` marker so language-filtered renderers can
+    // pair it with its EN counterpart (mirrors the event-line continuation).
+    koLines.push(`  └ 💡 ${tip.ko}`);
   }
   return { en: enLines.join('\n'), ko: koLines.join('\n') };
 }
@@ -288,7 +290,7 @@ export function recordCapTransition(window) {
     ko = `✓ ${labelKo} 캡 경고 해소`;
   }
   // Cap-warn entry → handoff tip; resolution → no tip (just the ✓ line).
-  const capTips = isWarn ? { en: `  💡 ${CAP_TIPS.en}`, ko: `  💡 ${CAP_TIPS.ko}` } : null;
+  const capTips = isWarn ? { en: `  💡 ${CAP_TIPS.en}`, ko: `  └ 💡 ${CAP_TIPS.ko}` } : null;
   appendDayLine(en, ko, now, capTips);
   state[slotKey] = isWarn;
   saveState(state);
@@ -310,6 +312,57 @@ export function recordHandoff(filePath) {
   return true;
 }
 
+/**
+ * Filter a daily-history file's content down to a single language.
+ *
+ * History files are written bilingual (EN line + `  └ KO` continuation +
+ * `  💡 EN tip` + `  └ 💡 KO tip`). This helper renders just the chosen side
+ * for display, while the on-disk file stays bilingual for archival.
+ *
+ *   en: drop every `  └ ...` line (KR continuations + KR tips).
+ *   ko: replace each EN line with the immediately following `  └ KO` line
+ *       (preserving the leading `- HH:MM:SS` from the EN line so timestamps
+ *       still appear); drop unpaired EN-only events.
+ *
+ * Lines that don't match the bilingual pattern (headers, blank lines,
+ * legacy entries from older versions without the `└ 💡` marker) pass through
+ * unchanged.
+ */
+export function formatHistoryForLanguage(content, lang) {
+  if (lang !== 'ko') {
+    // English: simply strip the `└` continuations.
+    return content
+      .split('\n')
+      .filter((line) => !/^\s*└\s/.test(line))
+      .join('\n');
+  }
+  // Korean: pair each line with its `└` continuation when present.
+  const lines = content.split('\n');
+  const out = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const next = lines[i + 1] || '';
+    const cont = next.match(/^(\s*)└\s+(.*)$/);
+    // Event line: `- HH:MM:SS <english>` → keep the timestamp prefix, swap text.
+    const evt = line.match(/^(- \d{2}:\d{2}:\d{2}\s+)(.*)$/);
+    if (evt && cont) {
+      out.push(`${evt[1]}${cont[2]}`);
+      i++;
+      continue;
+    }
+    // Tip line: `  💡 <english>` paired with `  └ 💡 <korean>`.
+    const tip = line.match(/^(\s*)💡\s+(.*)$/);
+    if (tip && cont && /^💡\s/.test(cont[2])) {
+      out.push(`${tip[1]}${cont[2]}`);
+      i++;
+      continue;
+    }
+    // Header / blank / unpaired line — pass through.
+    out.push(line);
+  }
+  return out.join('\n');
+}
+
 /**
  * List all available history file dates (sorted newest first).
  */