claude-token-saver 2.8.6 → 2.9.1

package/README.en.md

@@ -28,28 +28,27 @@ If postinstall was skipped (e.g. `--ignore-scripts`, sudo, or sandboxed installs
 claude-token-saver install
 ```
 
-## What you see after 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 58:38 · ✦ current █░░░░░ 15% 🔄 08:50 · 📅 weekly █▒░░░░ 24% 🔄 Thu 13:00 · 📦 Ctx 200k · 💰 Cache saved $205 · last 1d
 ```
 
-If a session spiked, a `⚠ Spike detected` block leads the report with root cause + a paste-ready remediation command.
+Segments — `🤖 model` · `🧠 cache hit rate` · `⏳ TTL countdown` · `✦ current` (5-hour window) · `📅 weekly` (7-day window) · `📦 context` · `💰 cumulative savings` · `last <window>`.
 
-**(B) Statusline chip** — once wired into `~/.claude/settings.json`:
+When excessive token usage is detected, a warning chip is prepended at the front of the statusline:
 
 ```
-🧠 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 · ✦ current ██████ 94% · 📦 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
+**What to do** — run the `/claude-token-saver` Skill in Claude. It calls `claude-token-saver last` and surfaces the root cause + step-by-step fix. Saying the chip wording out loud (e.g. "5H cap is up", "cache miss") also auto-activates the same Skill. See the [Skill workflow](#when-a-warning-chip-appears--skill-workflow) section below for the full flow.
+
+If postinstall was skipped (you already use a different statusline, etc.), wire it manually:
 
 ```json
 {
@@ -61,19 +60,59 @@ 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`.
+
+## When a warning chip appears — Skill workflow
+
+The Claude Code Skill registered at install time bridges "warning chip → remediation":
+
+1. **A risk chip appears in the statusline** — e.g. `🚨 5H 94%`, `⚠ Cache miss`, `⚠ 1M ON`.
+2. **Run `/claude-token-saver`** — invoking the Skill via slash is the simplest path. Mentioning the chip wording to Claude ("5H cap is up", "cache miss showing", "why is 1M context on?") auto-activates the same Skill.
+3. **The Skill fetches the remediation.** Internally it runs `claude-token-saver last` to surface the most recent warning + root-cause code + step-by-step fix, and recommends `claude-token-saver handoff` when a cap is imminent.
+4. **Run manually any time.** `claude-token-saver last` (latest event), `claude-token-saver history` (last 7 days of transitions), `claude-token-saver handoff` (back up before a cap blocks you) — same information, on demand.
+
+> v2.6.0 folded the legacy `/token-monitor` slash command into this Skill. On older installs, run `claude-token-saver install` once and the legacy file is cleaned up automatically.
+
+## 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
 
+All of the commands below run in your **shell (terminal)**. Inside a Claude Code session, the only entry point is the `/claude-token-saver` Skill, which calls these commands for you. The `--statusline` form is invoked automatically by Claude Code on each statusline refresh — you never type it yourself.
+
 | 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` | Manually register the Claude Code Skill (fallback when postinstall is skipped) |
+| `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
 
@@ -150,6 +189,26 @@ 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.1 (2026-04-27)
+- Fix the README statusline sample so it matches actual output (includes the `✦ current` / `📅 weekly` window segments that were missing).
+- Add a 4-step "When a warning chip appears" Skill workflow — spot the chip → mention its wording to Claude → Skill runs `last` → apply remediation.
+- Move `language` from `cfg.statusline.language` to top-level `cfg.language` (it doesn't belong with statusline toggles). The legacy location is still read as a fallback so existing configs migrate transparently. `mode` output also splits the statusline section from the output-language section.
+
+### 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

@@ -28,28 +28,27 @@ npm i -g claude-token-saver
 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 58:38 · ✦ current █░░░░░ 15% 🔄 08:50 · 📅 weekly █▒░░░░ 24% 🔄 Thu 13:00 · 📦 Ctx 200k · 💰 Cache saved $205 · last 1d
 ```
 
-급증 세션이 있으면 상단에 `⚠ 토큰 급증 감지` 블록과 원인·해결 명령이 함께 출력됩니다.
+세그먼트 — `🤖 모델` · `🧠 캐시 히트율` · `⏳ TTL 카운트다운` · `✦ current` (5시간 윈도) · `📅 weekly` (7일 윈도) · `📦 컨텍스트` · `💰 누적 절감액` · `last <기간>`.
 
-**(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 · ✦ current ██████ 94% · 📦 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 등록
+**해야 할 일** — Claude에서 `/claude-token-saver` Skill을 실행하면 됩니다. Skill이 `claude-token-saver last`를 호출해 원인 코드와 단계별 해결 명령을 자동으로 보여줍니다. 칩 문구(예: "5H cap 떴어", "cache miss")만 말해도 동일한 Skill이 자동 활성화됩니다. 자세한 흐름은 아래 [Skill 워크플로](#경고-칩이-떴을-때--skill-워크플로) 참고.
+
+수동 등록이 필요한 경우(다른 statusline을 이미 쓰고 있어 postinstall이 건너뛴 경우 등):
 
 ```json
 {
@@ -61,19 +60,59 @@ TTL Breakdown / Cost Impact / Daily Trend ...
 }
 ```
 
-`refreshInterval: 5`는 idle 상태에서도 TTL 카운트다운을 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이 "경고 칩 → 처방"의 다리 역할을 합니다.
+
+1. **statusline에 경고 칩이 뜬다** — 예: `🚨 5H 94%`, `⚠ Cache miss`, `⚠ 1M ON`.
+2. **`/claude-token-saver` Skill을 실행한다** — Claude에서 슬래시로 Skill을 직접 호출하는 게 가장 간단합니다. 또는 칩 문구를 그대로 말해도 동일한 Skill이 자동 활성화됩니다 ("5H cap 떴어", "cache miss 떴어", "1M context 왜 켜졌지?" 등 — 칩 텍스트가 트리거 단어로 등록돼 있음).
+3. **Skill이 처방을 가져온다** — 내부적으로 `claude-token-saver last`를 실행해 가장 최근 경고 + 원인 코드 + 단계별 해결 명령을 한 번에 보여주고, 캡 임박 시에는 `claude-token-saver handoff`로 현재 작업 백업을 권합니다.
+4. **수동 확인이 필요하면** — `claude-token-saver last` (최근 1건), `claude-token-saver history` (최근 7일 전이 로그), `claude-token-saver handoff` (cap 직전 백업)를 직접 실행해도 같은 정보를 얻을 수 있습니다.
+
+> 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 Code 세션 안에서는 `/claude-token-saver` Skill 하나만 쓰며, Skill이 내부적으로 이 명령들을 호출합니다. `--statusline` 형식은 Claude Code가 statusline 갱신마다 자동으로 호출하므로 사용자가 직접 입력하지 않습니다.
+
 | 명령 | 설명 |
 |---|---|
-| `claude-token-saver` | 최근 30일 진단 리포트 |
-| `claude-token-saver --days 7` | 기간 변경 |
-| `claude-token-saver --statusline --icon` | statusline용 한 줄 출력 |
-| `claude-token-saver install` | Claude Code Skill 수동 등록 (postinstall이 막힌 환경 대비) |
+| `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).
 
@@ -110,6 +149,26 @@ 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 등)에는 영향 없습니다.
 
+## 릴리스 노트
+
+### v2.9.1 (2026-04-27)
+- README의 statusline 예시를 실제 출력(`✦ current` / `📅 weekly` 윈도 세그먼트 포함)으로 정정.
+- "경고 칩이 떴을 때" Skill 워크플로 4단계 가이드 추가 — 칩 발견 → Claude에게 칩 문구 그대로 말하기 → Skill이 `last` 실행 → 처방 적용.
+- `language` 설정 위치를 `cfg.statusline` 하위에서 top-level `cfg.language`로 이동(statusline 토글이 아니므로). 구버전 위치도 fallback으로 계속 읽어 마이그레이션은 자동. `mode` 출력도 statusline / output language를 분리해서 표시.
+
+### 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`를 참고하세요.
+
 ## 라이선스
 
 MIT

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;
@@ -393,20 +396,23 @@ async function main() {
   //   claude-token-saver mode icon verbose       # set icon + verbose
   //   claude-token-saver mode reset              # clear back to defaults
   if (args[0] === 'mode') {
-    const { applyMode, loadConfig, configPath, statuslineDefaults, VALID_KEYWORDS } =
+    const { applyMode, loadConfig, configPath, statuslineDefaults, userLanguage, VALID_KEYWORDS } =
       await import('../src/config.js');
     const words = args.slice(1);
     if (words.length === 0) {
       const eff = statuslineDefaults();
-      const raw = loadConfig().statusline || {};
-      console.log('Statusline mode (effective):');
+      const raw = loadConfig();
+      console.log('Statusline (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('');
-      console.log(`Stored config (${configPath()}):`);
+      console.log('Output language (advice / history / last):');
+      console.log(`  language: ${userLanguage()}`);
+      console.log('');
+      console.log(`Stored config file (${configPath()}):`);
       console.log(`  ${Object.keys(raw).length === 0 ? '(none — using defaults)' : JSON.stringify(raw)}`);
       console.log('');
       console.log('Change with: claude-token-saver mode <keywords...>');
@@ -421,7 +427,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} window=${eff.windowLabel} language=${userLanguage()}`);
     console.log('Statusline picks up the change on the next refresh (~1s).');
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "2.8.6",
+  "version": "2.9.1",
   "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
   "type": "module",
   "bin": {

package/src/config.js

@@ -36,6 +36,7 @@ export function saveConfig(cfg) {
 
 // Each keyword maps to a single statusline option toggle.
 // Orthogonal — `mode icon verbose` flips both without resetting the rest.
+// Statusline-only toggles. Stored under `cfg.statusline`.
 const KEYWORDS = {
   icon:       { key: 'icon',    value: true  },
   text:       { key: 'icon',    value: false },
@@ -47,6 +48,16 @@ const KEYWORDS = {
   'no-color': { key: 'color',   value: false },
 };
 
+// Output language for `last`/`history`/advice. Stored at top level
+// (`cfg.language`) because it has nothing to do with statusline rendering —
+// the chips themselves stay symbolic regardless.
+const LANG_KEYWORDS = {
+  en:      'en',
+  english: 'en',
+  ko:      'ko',
+  korean:  'ko',
+};
+
 // Window preset accepts forms like:
 //   `1h`, `6h`, `24h`        — hours
 //   `1d`, `7d`, `30d`        — days (× 24h)
@@ -65,12 +76,15 @@ function parseWindow(word) {
   return null;
 }
 
-export const VALID_KEYWORDS = Object.keys(KEYWORDS).concat([
-  '<N>h (e.g. 1h, 6h, 24h)',
-  '<N>d (e.g. 1d, 7d, 30d)',
-  'reset',
-  'default',
-]);
+export const VALID_KEYWORDS = Object.keys(KEYWORDS)
+  .concat(Object.keys(LANG_KEYWORDS))
+  .concat([
+    '<N>h (e.g. 1h, 6h, 24h)',
+    '<N>d (e.g. 1d, 7d, 30d)',
+    'lang=en | lang=ko',
+    'reset',
+    'default',
+  ]);
 
 /**
  * Apply user-supplied mode keywords to the persisted config.
@@ -87,9 +101,25 @@ export function applyMode(words) {
     const lower = String(w).toLowerCase();
     if (lower === 'reset' || lower === 'default') {
       cfg.statusline = {};
+      delete cfg.language;
       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.language = v;
+      // Migrate any legacy value that lived under cfg.statusline.language.
+      if (cfg.statusline) delete cfg.statusline.language;
+      applied.push(`lang=${v}`);
+      continue;
+    }
+    if (LANG_KEYWORDS[lower]) {
+      cfg.language = LANG_KEYWORDS[lower];
+      if (cfg.statusline) delete cfg.statusline.language;
+      applied.push(`lang=${cfg.language}`);
+      continue;
+    }
     const hours = parseWindow(lower);
     if (hours !== null && hours > 0) {
       cfg.statusline.windowHours = hours;
@@ -141,6 +171,17 @@ export function statuslineDefaults() {
   };
 }
 
+// Resolve the user's preferred output language for advice/history/last.
+// Returns 'en' or 'ko'; defaults to 'en' for first-time users.
+// Reads `cfg.language` (current location) with a fallback to the legacy
+// `cfg.statusline.language` slot so configs from earlier 2.9.x installs
+// keep working.
+export function userLanguage() {
+  const cfg = loadConfig();
+  const v = cfg.language || (cfg.statusline && cfg.statusline.language);
+  return v === '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).
  */