claude-cost-cry 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shimsuyeon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,173 @@
+# 🪙 claude-cost-cry
+
+> 당신의 API 비용을 감정적으로 체감시켜주는 도구
+
+숫자로 보면 무감각한 API 비용을, **아이스 아메리카노와 치킨으로 환산하면 아프다.**
+
+[English](README.md)
+
+## 뭐하는 도구인가요?
+
+Claude Code(및 기타 LLM 프로바이더) 사용 시 실시간으로 비용을 추적하면서, 돈이 날아가는 순간을 감정 메시지, 일상 환산, 플로팅 위젯으로 체감시켜줍니다.
+
+```
+$ cost-cry
+
+  🪙 claude-cost-cry v0.3.0
+  당신의 API 비용을 감정적으로 체감시켜드립니다
+
+  📊 오늘 누적: $2.41 (☕ 아이스 아메리카노 0.5잔)
+     API 호출 12건
+     🌤️ 조금씩 쓰고 있네요...
+
+  ────────────────────────────────────────────────────────
+  감시 중... (Ctrl+C로 종료)
+  ────────────────────────────────────────────────────────
+
+  [14:32:15] Opus  📥 15.2K 📤 1.2K
+  🔥 +$0.38  →  누적: $8.73  🍗 0.5마리
+     "이 돈이면 고급 뷔페를 갈 수 있었는데..."
+
+  [14:35:22] Sonnet  📥 8.3K 📤 2.1K
+  💸 +$0.06  →  누적: $8.79  🍗 0.5마리
+     "지갑이 울고 있어요 진짜로"
+```
+
+## 비용 구간별 감정 이펙트
+
+| 비용 구간 | 이모지 | 기분 | 메시지 예시 |
+|-----------|-------|------|------------|
+| $0 ~ $1 | 🪙 | 평화 | "아직 괜찮아요, 이 정도는 공기값이죠" |
+| $1 ~ $5 | 💸 | 불안 | "슬슬 자판기 커피값이 되어가네요..." |
+| $5 ~ $10 | 🔥 | 걱정 | "이거 진짜 괜찮은 건가요...?" |
+| $10 ~ $30 | 🚨 | 경고 | "클로드한테 월급을 주는 건가..." |
+| $30 ~ $100 | 💀 | 공포 | "은행 잔고가 비명을 지르고 있습니다" |
+| $100+ | ⚰️ | 장례식 | "🚨 경고: 이 API 키는 불에 타고 있습니다 🚨" |
+
+## 설치
+
+```bash
+npm install -g claude-cost-cry
+```
+
+## 사용법
+
+### 오버레이 모드 (플로팅 위젯) — 기본
+
+```bash
+cost-cry
+```
+
+화면 오른쪽 위에 떠 있는 위젯으로 실시간 비용을 확인합니다:
+- 비용 구간에 따라 이모지와 글자 색상이 변합니다
+- 새 API 호출 시 바운스 애니메이션 + 비용 플래시
+- $30 이상이면 위젯이 흔들립니다
+- 시스템 트레이에서 위젯 열기/닫기 가능
+- 드래그로 위치 이동 가능
+- 확장 패널: 일별 차트, 모델별 비용, TOP 3 비싼 요청, 설정
+
+> macOS에서 처음 실행 시 `xattr -cr node_modules/electron/dist/Electron.app` 실행이 필요할 수 있습니다.
+
+### CLI 모드 (터미널)
+
+```bash
+cost-cry cli
+```
+
+터미널에서 실시간 추적:
+1. 오늘의 누적 비용을 스캔하여 보여줍니다
+2. Claude Code 사용을 실시간으로 감시합니다
+3. API 호출이 감지될 때마다 비용과 감정 메시지를 표시합니다
+4. `Ctrl+C`로 종료하면 세션 요약을 보여줍니다
+
+### 리포트
+
+```bash
+cost-cry report            # 주간 리포트
+cost-cry report --monthly  # 월간 리포트
+```
+
+일별 비용 ASCII 차트, 모델별 비용 분석, 절약 시뮬레이션을 제공합니다.
+
+### 설정
+
+```bash
+cost-cry config                     # 현재 설정 보기
+cost-cry config --daily-budget 10   # 일일 예산 $10 설정
+cost-cry config --daily-budget off  # 예산 해제
+cost-cry config --currency KRW      # 표시 통화 변경
+cost-cry config --nudge off         # 절약 넛지 끄기
+cost-cry config --language en       # 영어로 전환
+cost-cry config --add-source cursor # Cursor IDE 추적
+```
+
+#### 예산 알림
+
+예산을 설정하면:
+- 70% 도달 시 💡 경고, 90% 시 ⚠️ 경고, 100% 초과 시 🚫 경고
+- CLI와 오버레이 위젯 모두에서 표시됩니다
+
+#### 절약 넛지
+
+API 호출 시 더 저렴한 모델을 썼으면 얼마를 아낄 수 있었는지 실시간으로 보여줍니다:
+
+```
+  [14:32:15] Opus  📥 15.2K 📤 1.2K
+  🔥 +$0.38  →  누적: $8.73
+     💡 Haiku로 했으면 $0.02 ($0.36 절약)
+```
+
+#### 멀티 프로바이더 지원
+
+여러 LLM 프로바이더의 비용을 함께 추적합니다:
+- 🟣 **Claude Code** — 자동 (로컬 JSONL 로그)
+- ⚡ **Cursor IDE** — API 폴링 (`cost-cry config --add-source cursor`)
+- 🟢 **OpenAI** — 로컬 로그 (`cost-cry config --add-source openai:/path/to/logs`)
+- 🔵 **Google Gemini** — 로컬 로그 (`cost-cry config --add-source google:/path/to/logs`)
+
+#### 언어
+
+기본 언어는 **영어**입니다. 한국어로 전환:
+
+```bash
+cost-cry config --language ko
+```
+
+오버레이 설정 패널에서도 변경 가능합니다.
+
+## 작동 원리
+
+Claude Code는 모든 API 호출 로그를 `~/.claude/projects/` 아래에 JSONL 파일로 저장합니다. cost-cry는 이 로그 파일을 실시간으로 감시하며:
+
+1. 새로운 assistant 응답의 `usage` 필드에서 토큰 사용량을 추출
+2. 모델별 공식 가격표를 기반으로 비용을 계산
+3. 비용 구간에 맞는 감정 메시지를 표시
+
+**프록시나 API 키가 필요 없습니다.** 로컬 로그 파일만 읽습니다 (또는 Cursor 내부 API 폴링).
+
+## 지원 모델 & 가격
+
+| 모델 | 입력 ($/1M) | 출력 ($/1M) |
+|------|-----------|-----------|
+| Claude Opus | $15.00 | $75.00 |
+| Claude Sonnet | $3.00 | $15.00 |
+| Claude Haiku | $0.80 | $4.00 |
+| GPT-4o | $2.50 | $10.00 |
+| GPT-4o mini | $0.15 | $0.60 |
+| Gemini 2.5 Pro | $1.25 | $10.00 |
+| Gemini Flash | $0.075 | $0.30 |
+
+캐시 토큰도 자동 반영됩니다 (쓰기: 1.25x, 읽기: 0.1x).
+
+## 요구 사항
+
+- Node.js >= 18
+- Claude Code 설치 (`~/.claude/` 디렉토리) 또는 기타 지원 프로바이더
+
+## 면책 조항
+
+이 도구의 비용 계산은 **참고용**입니다. 정확한 과금 금액은 [Anthropic 대시보드](https://console.anthropic.com/)에서 확인하세요.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,174 @@
+# 🪙 claude-cost-cry
+
+> Emotionally experience your API costs
+
+Numbers feel numb. But **when your API bill becomes iced americanos and fried chicken, it hurts.**
+
+[한국어](README.ko.md)
+
+## What is this?
+
+A real-time cost tracker for Claude Code (and other LLM providers) that makes you *feel* every dollar leaving your wallet — with emotional messages, everyday equivalents, and a floating desktop widget.
+
+```
+$ cost-cry
+
+  🪙 claude-cost-cry v0.3.0
+  Emotionally experience your API costs
+
+  📊 Today's total: $2.41 (☕ Iced Americano 0.5)
+     12 API calls
+     🌤️ Starting to spend a bit...
+
+  ────────────────────────────────────────────────────────
+  Watching... (Ctrl+C to exit)
+  ────────────────────────────────────────────────────────
+
+  [14:32:15] Opus  📥 15.2K 📤 1.2K
+  🔥 +$0.38  →  Total: $8.73  🍗 0.5
+     "Could've gone to a fancy buffet with this money..."
+
+  [14:35:22] Sonnet  📥 8.3K 📤 2.1K
+  💸 +$0.06  →  Total: $8.79  🍗 0.5
+     "Your wallet is literally crying"
+```
+
+## Emotional Cost Tiers
+
+| Cost Range | Emoji | Mood | Example Message |
+|-----------|-------|------|-----------------|
+| $0 – $1 | 🪙 | Peace | "No worries, this is practically free" |
+| $1 – $5 | 💸 | Uneasy | "Starting to cost as much as vending machine coffee..." |
+| $5 – $10 | 🔥 | Worry | "Is this really okay...?" |
+| $10 – $30 | 🚨 | Alert | "Am I paying Claude a salary...?" |
+| $30 – $100 | 💀 | Danger | "The bank account is screaming" |
+| $100+ | ⚰️ | Funeral | "🚨 WARNING: This API key is on fire 🚨" |
+
+## Installation
+
+```bash
+npm install -g claude-cost-cry
+```
+
+## Usage
+
+### Overlay Mode (Floating Widget) — Default
+
+```bash
+cost-cry
+```
+
+Launches a floating desktop widget (top-right corner) that tracks costs in real time:
+- Emoji and color change based on cost tier
+- Bounce animation + cost flash on new API calls
+- Widget shakes when cost exceeds $30
+- Toggle from system tray
+- Drag to reposition
+- Expandable panels: daily chart, model breakdown, top 3 expensive requests, settings
+
+> On macOS, you may need to run `xattr -cr node_modules/electron/dist/Electron.app` on first launch.
+
+### CLI Mode (Terminal)
+
+```bash
+cost-cry cli
+```
+
+Real-time tracking in your terminal:
+1. Scans today's accumulated cost
+2. Watches for new Claude Code API calls in real time
+3. Displays cost + emotional message on each call
+4. Shows session summary on `Ctrl+C` exit
+
+### Reports
+
+```bash
+cost-cry report            # Weekly report
+cost-cry report --monthly  # Monthly report
+```
+
+ASCII bar charts with per-day costs, model breakdown, and savings simulation.
+
+### Configuration
+
+```bash
+cost-cry config                     # View current settings
+cost-cry config --daily-budget 10   # Set daily budget ($10)
+cost-cry config --daily-budget off  # Remove budget
+cost-cry config --currency KRW      # Switch display currency
+cost-cry config --nudge off         # Disable savings nudge
+cost-cry config --language ko       # Switch to Korean
+cost-cry config --add-source cursor # Track Cursor IDE usage
+```
+
+#### Budget Alerts
+
+When a budget is set:
+- 70% → 💡 warning, 90% → ⚠️ warning, 100% → 🚫 exceeded
+- Displayed in both CLI and overlay widget
+
+#### Savings Nudge
+
+Shows how much you could save using a cheaper model — in real time:
+
+```
+  [14:32:15] Opus  📥 15.2K 📤 1.2K
+  🔥 +$0.38  →  Total: $8.73
+     💡 Would be $0.02 with Haiku (save $0.36)
+```
+
+#### Multi-Provider Support
+
+Track costs across multiple LLM providers:
+- 🟣 **Claude Code** — automatic (local JSONL logs)
+- ⚡ **Cursor IDE** — API polling (`cost-cry config --add-source cursor`)
+- 🟢 **OpenAI** — local logs (`cost-cry config --add-source openai:/path/to/logs`)
+- 🔵 **Google Gemini** — local logs (`cost-cry config --add-source google:/path/to/logs`)
+
+#### Language
+
+Default language is **English**. Switch to Korean:
+
+```bash
+cost-cry config --language ko
+```
+
+Also available in the overlay settings panel.
+
+## How It Works
+
+Claude Code saves all API call logs as JSONL files under `~/.claude/projects/`. cost-cry watches these files in real time:
+
+1. Extracts token usage from the `usage` field of assistant responses
+2. Calculates cost based on official model pricing
+3. Displays emotional messages based on cost tier
+
+**No proxy or API key required.** Only reads local log files (or polls Cursor's internal API).
+
+## Supported Models & Pricing
+
+| Model | Input ($/1M) | Output ($/1M) |
+|-------|-------------|---------------|
+| Claude Opus | $15.00 | $75.00 |
+| Claude Sonnet | $3.00 | $15.00 |
+| Claude Haiku | $0.80 | $4.00 |
+| GPT-4o | $2.50 | $10.00 |
+| GPT-4o mini | $0.15 | $0.60 |
+| Gemini 2.5 Pro | $1.25 | $10.00 |
+| Gemini Flash | $0.075 | $0.30 |
+
+Cache tokens are automatically reflected (write: 1.25x, read: 0.1x).
+
+## Requirements
+
+- Node.js >= 18
+- Claude Code installed (`~/.claude/` directory) or another supported provider
+
+## Disclaimer
+
+Cost calculations are **estimates for reference**. For exact billing, check the [Anthropic Dashboard](https://console.anthropic.com/).
+
+## License
+
+MIT
+

package/bin/cli.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const { t, setLocale } = await import('../dist/i18n.js');
+const { loadConfig: _lc } = await import('../dist/config.js');
+const _initCfg = _lc();
+if (_initCfg.language) setLocale(_initCfg.language);
+
+if (command === 'config') {
+  const { updateConfig, loadConfig } = await import('../dist/config.js');
+  const { showConfigUpdate, showInfo } = await import('../dist/display.js');
+
+  const flags = args.slice(1);
+
+  const { getAllEquivalents } = await import('../dist/calculator.js');
+
+  if (flags.length === 0) {
+    const config = loadConfig();
+    const { getExchangeRate, SUPPORTED_CURRENCIES } = await import('../dist/exchange.js');
+    const allItems = getAllEquivalents(config);
+    const unitKey = config.equivalentUnit || 'auto';
+    const matchedUnit = unitKey === 'auto' ? null : allItems.find(i => i.key === unitKey || i.name === unitKey);
+    const unitDisplay = unitKey === 'auto'
+      ? t('cli.autoUnit')
+      : matchedUnit ? `${matchedUnit.emoji} ${matchedUnit.name}` : unitKey;
+    const exchange = await getExchangeRate(config);
+    console.log();
+    showInfo(t('cli.currentConfig'));
+    console.log(`  ${t('cli.dailyBudget')}    ${config.dailyBudget ? `$${config.dailyBudget}` : t('cli.noLimit')}`);
+    console.log(`  ${t('cli.monthlyBudget')}    ${config.monthlyBudget ? `$${config.monthlyBudget}` : t('cli.noLimit')}`);
+    console.log(`  ${t('cli.currency')}         ${config.currency || 'USD'}`);
+    if (exchange && exchange.currency !== 'USD') {
+      const srcLabel = {
+        api: t('exchange.src.api'), cache: t('exchange.src.cache'),
+        'stale-cache': t('exchange.src.staleCache'), manual: t('exchange.src.manual'), base: ''
+      };
+      console.log(`  ${t('cli.exchangeRate')}      1 USD = ${exchange.rate.toLocaleString()} ${exchange.currency} (${srcLabel[exchange.source] || ''} ${exchange.updatedAt || ''})`);
+    }
+    if (config.exchangeRate) {
+      console.log(`  ${t('cli.exchangeFixed')}    ${config.exchangeRate}`);
+    }
+    console.log(`  ${t('cli.nudge')}    ${config.showNudge ? t('cli.nudgeOn') : t('cli.nudgeOff')}`);
+    console.log(`  ${t('cli.equivUnit')}    ${unitDisplay}`);
+    if (config.customEquivalents?.length > 0) {
+      console.log(`  ${t('cli.customUnits')}  ${config.customEquivalents.map(e => `${e.emoji} ${e.name}`).join(', ')}`);
+    }
+    console.log(`  ${t('cli.language')}        ${config.language || 'en'}`);
+    console.log();
+    if (config.logSources?.length > 0) {
+      console.log(`  ${t('cli.logSources')}`);
+      console.log(`     🟣 ${t('cli.claudeAuto')}`);
+      for (const src of config.logSources) {
+        const providerEmoji = { claude: '🟣', openai: '🟢', google: '🔵', cursor: '⚡' }[src.provider] || '⚪';
+        if (src.path) {
+          console.log(`     ${providerEmoji} ${src.provider}: ${src.path}`);
+        } else {
+          console.log(`     ${providerEmoji} ${src.provider} ${t('cli.apiPolling')}`);
+        }
+      }
+    } else {
+      console.log(`  ${t('cli.logSources')}    🟣 ${t('cli.claudeAuto')}`);
+    }
+    console.log();
+    console.log(`  ${t('cli.availableUnits')} ${allItems.map(e => e.name).join(', ')}`);
+    console.log(`  ${t('cli.supportedCurrencies')} ${SUPPORTED_CURRENCIES.join(', ')}`);
+    console.log();
+    showInfo(t('cli.configHint'));
+    console.log();
+    process.exit(0);
+  }
+
+  for (let i = 0; i < flags.length; ) {
+    const key = flags[i];
+    const value = flags[i + 1];
+
+    switch (key) {
+      case '--daily-budget':
+      case '-d':
+        updateConfig({ dailyBudget: value === 'off' ? null : parseFloat(value) });
+        showConfigUpdate(t('cli.dailyBudget'), value === 'off' ? t('cli.noLimit') : `$${value}`);
+        i += 2;
+        break;
+      case '--monthly-budget':
+        updateConfig({ monthlyBudget: value === 'off' ? null : parseFloat(value) });
+        showConfigUpdate(t('cli.monthlyBudget'), value === 'off' ? t('cli.noLimit') : `$${value}`);
+        i += 2;
+        break;
+      case '--nudge':
+        updateConfig({ showNudge: value !== 'off' });
+        showConfigUpdate(t('cli.nudge'), value === 'off' ? t('cli.nudgeOff') : t('cli.nudgeOn'));
+        i += 2;
+        break;
+      case '--unit': {
+        let unitVal = value;
+        if (value !== 'auto') {
+          const items = getAllEquivalents(loadConfig());
+          const match = items.find(i => i.key === value || i.name === value);
+          unitVal = match?.key || value;
+        }
+        updateConfig({ equivalentUnit: unitVal });
+        showConfigUpdate(t('cli.equivUnit'), value === 'auto' ? t('cli.autoUnit') : value);
+        i += 2;
+        break;
+      }
+      case '--add-unit': {
+        const parts = value.split(':');
+        if ((parts.length !== 3 && parts.length !== 4) || isNaN(parseFloat(parts[1]))) {
+          console.error(`  ${t('cli.unitFormatError')}`);
+          process.exit(1);
+        }
+        const defaultUnit = t('display.defaultUnit') || '';
+        const newItem = { name: parts[0], price: parseFloat(parts[1]), emoji: parts[2], unit: parts[3] || defaultUnit };
+        const cfg = loadConfig();
+        const customs = (cfg.customEquivalents || []).filter(e => e.name !== newItem.name);
+        customs.push(newItem);
+        updateConfig({ customEquivalents: customs });
+        showConfigUpdate(t('cli.customUnits'), `${newItem.emoji} ${newItem.name} ($${newItem.price})`);
+        i += 2;
+        break;
+      }
+      case '--remove-unit': {
+        const cfg2 = loadConfig();
+        const filtered = (cfg2.customEquivalents || []).filter(e => e.name !== value);
+        updateConfig({ customEquivalents: filtered });
+        showConfigUpdate(t('cli.customUnits'), value);
+        i += 2;
+        break;
+      }
+      case '--currency': {
+        const { SUPPORTED_CURRENCIES } = await import('../dist/exchange.js');
+        const cur = value.toUpperCase();
+        if (!SUPPORTED_CURRENCIES.includes(cur)) {
+          console.error(`  ${t('cli.unknownCurrency', { currency: cur, supported: SUPPORTED_CURRENCIES.join(', ') })}`);
+          process.exit(1);
+        }
+        updateConfig({ currency: cur });
+        showConfigUpdate(t('cli.currency'), cur);
+        i += 2;
+        break;
+      }
+      case '--exchange-rate': {
+        if (value === 'auto') {
+          updateConfig({ exchangeRate: null });
+          showConfigUpdate(t('cli.exchangeRate'), 'Auto (API)');
+        } else {
+          const rate = parseFloat(value);
+          if (isNaN(rate) || rate <= 0) {
+            console.error(`  ${t('cli.invalidRate')}`);
+            process.exit(1);
+          }
+          updateConfig({ exchangeRate: rate });
+          showConfigUpdate(t('cli.exchangeFixed'), `${rate}`);
+        }
+        i += 2;
+        break;
+      }
+      case '--add-source': {
+        const { getProviderNames, getProvider: gp } = await import('../dist/providers/index.js');
+        const colonIdx = value.indexOf(':');
+
+        if (colonIdx === -1) {
+          const provider = gp(value);
+          if (!provider) {
+            console.error(`  ${t('cli.unknownProvider', { provider: value, supported: getProviderNames().join(', ') })}`);
+            process.exit(1);
+          }
+          if (provider.isApiProvider) {
+            if (!provider.isAvailable?.()) {
+              console.error(`  ${t('cli.notInstalled', { provider: provider.displayName })}`);
+              process.exit(1);
+            }
+            if (!provider.getSessionToken?.()) {
+              console.error(`  ${t('cli.noToken', { provider: provider.displayName })}`);
+              process.exit(1);
+            }
+            const cfg3 = loadConfig();
+            const sources = (cfg3.logSources || []).filter(s => s.provider !== value);
+            sources.push({ provider: value });
+            updateConfig({ logSources: sources });
+            showConfigUpdate(t('cli.logSources'), `${provider.emoji} ${provider.displayName} ${t('cli.apiPolling')}`);
+          } else {
+            console.error(`  ${t('cli.sourceFormatError')}`);
+            console.error(`  ${t('cli.apiSourceHint')}`);
+            console.error(`  ${t('cli.providerHint', { providers: getProviderNames().join(', ') })}`);
+            process.exit(1);
+          }
+          i += 2;
+          break;
+        }
+
+        const srcProvider = value.slice(0, colonIdx);
+        const srcPath = value.slice(colonIdx + 1);
+        if (!getProviderNames().includes(srcProvider)) {
+          console.error(`  ${t('cli.unknownProvider', { provider: srcProvider, supported: getProviderNames().join(', ') })}`);
+          process.exit(1);
+        }
+        const cfg3 = loadConfig();
+        const sources = (cfg3.logSources || []).filter(s => !(s.provider === srcProvider && s.path === srcPath));
+        sources.push({ provider: srcProvider, path: srcPath });
+        updateConfig({ logSources: sources });
+        showConfigUpdate(t('cli.logSources'), `${srcProvider}:${srcPath}`);
+        i += 2;
+        break;
+      }
+      case '--remove-source': {
+        const cfg4 = loadConfig();
+        const colonIdx2 = value.indexOf(':');
+        let filtered2;
+        if (colonIdx2 !== -1) {
+          const rp = value.slice(0, colonIdx2);
+          const rpath = value.slice(colonIdx2 + 1);
+          filtered2 = (cfg4.logSources || []).filter(s => !(s.provider === rp && s.path === rpath));
+        } else {
+          filtered2 = (cfg4.logSources || []).filter(s => s.provider !== value);
+        }
+        updateConfig({ logSources: filtered2 });
+        showConfigUpdate(t('cli.logSources'), value);
+        i += 2;
+        break;
+      }
+      case '--language': {
+        const lang = value?.toLowerCase();
+        if (lang !== 'en' && lang !== 'ko') {
+          console.error(`  ${t('cli.unknownLang', { lang: value })}`);
+          process.exit(1);
+        }
+        updateConfig({ language: lang });
+        setLocale(lang);
+        showConfigUpdate(t('cli.language'), lang);
+        i += 2;
+        break;
+      }
+      default:
+        console.error(`  ${t('cli.unknownOption', { option: key })}`);
+        process.exit(1);
+    }
+  }
+} else if (command === 'report') {
+  const { showWeeklyReport, showMonthlyReport } = await import('../dist/report.js');
+  const { showBanner } = await import('../dist/display.js');
+
+  showBanner();
+
+  const isMonthly = args.includes('--monthly') || args.includes('-m');
+
+  if (isMonthly) {
+    await showMonthlyReport();
+  } else {
+    await showWeeklyReport();
+  }
+} else if (command === 'cli') {
+  const { main } = await import('../dist/index.js');
+  main().catch((err) => {
+    console.error(`${t('cli.fatalError')} ${err.message}`);
+    process.exit(1);
+  });
+} else if (args.includes('--help') || args.includes('-h')) {
+  showHelp();
+} else {
+  launchOverlay();
+}
+
+function showHelp() {
+  console.log(`
+  ${t('cli.title')}
+
+  ${t('cli.usage')}
+    cost-cry                            ${t('cli.cmdOverlay')}
+    cost-cry cli                        ${t('cli.cmdCli')}
+    cost-cry config                     ${t('cli.cmdConfig')}
+    cost-cry config [options]           ${t('cli.cmdConfigEdit')}
+    cost-cry report                     ${t('cli.cmdReport')}
+    cost-cry report --monthly           ${t('cli.cmdReportMonthly')}
+
+  ${t('cli.settingsTitle')}
+    --daily-budget <amount>    Daily budget (USD). Off: --daily-budget off
+    --monthly-budget <amount>  Monthly budget (USD). Off: --monthly-budget off
+    --nudge <on|off>           Savings nudge
+    --unit <name|auto>         Fixed equivalent unit. Auto: --unit auto
+    --add-unit "name:price:emoji:unit"  Add custom equivalent unit
+    --remove-unit <name>       Remove custom equivalent unit
+    --currency <code>          Display currency (USD, KRW, JPY, EUR, GBP, CNY)
+    --exchange-rate <num|auto> Fix exchange rate manually. Auto: --exchange-rate auto
+    --add-source "provider:path"  Add log source (openai, google)
+    --add-source cursor            Track Cursor IDE usage (API polling)
+    --remove-source <provider>    Remove log source
+    --language <en|ko>         Set language
+  
+  ${t('cli.examplesTitle')}
+    cost-cry config --daily-budget 10
+    cost-cry config --currency KRW
+    cost-cry config --add-source cursor
+    cost-cry config --language ko
+  `);
+}
+
+async function launchOverlay() {
+  const { spawn } = await import('node:child_process');
+  const { createRequire } = await import('node:module');
+  const { fileURLToPath } = await import('node:url');
+  const path = await import('node:path');
+
+  const __dirname = path.dirname(fileURLToPath(import.meta.url));
+  const require = createRequire(import.meta.url);
+
+  let electronPath;
+  try {
+    electronPath = require('electron');
+  } catch {
+    console.error(t('cli.noElectron'));
+    console.error(t('cli.installElectron'));
+    process.exit(1);
+  }
+
+  const appPath = path.join(__dirname, '..', 'electron');
+
+  try {
+    const child = spawn(electronPath, [appPath], {
+      detached: true,
+      stdio: 'ignore',
+    });
+
+    child.unref();
+
+    console.log(t('cli.widgetLaunched'));
+    process.exit(0);
+  } catch (err) {
+    console.error(`${t('cli.electronFail')} ${err.message}`);
+    process.exit(1);
+  }
+}