pinglet-cli 0.6.2 → 0.7.0

package/README.ja.md

@@ -58,6 +58,46 @@ pinglet post "メッセージ"
 
 statusline の言語はシステム言語に応じて自動選択されます(韓国語/日本語、それ以外は英語)。言語で判定できない場合はタイムゾーン(ソウル/東京)で推定します。
 
+## HUD — セッション情報を statusline に
+
+「一緒にコーディング中」の行の下に、[claude-hud](https://github.com/jarrodwatts/claude-hud) と同じ方式の HUD が表示されます。
+モデルと effort レベル、プロジェクト・git ブランチ（変更行数・未プッシュのコミット）、`/advisor` モデル、セッション時間・コスト・出力速度、
+コンテキスト使用率バー、5時間/7日/モデル別週間の使用量上限、prompt cache の期限時刻、端末の RAM 使用率、
+実行中のツール・呼び出したスキル・サブエージェント・todo の進捗、変更ファイル一覧、セッション累計トークン、圧縮回数です。
+
+```
+🟢 いま41個のターミナルと一緒にコーディング中
+[Opus 5 ◑ high] │ my-project git:(main* ↑2 [+337 -29]) │ アドバイザー: Opus 4.7 │ ⏱ 56m │ コスト $1.23 │ 出力: 42.1 tok/s
+コンテキスト ████░░░░░░ 45% │ 使用量 ███░░░░░░░ 31% (リセットまで 1h 7m) | 週間 █████████░ 85% (リセットまで 2d 7h) │ キャッシュ ⏱ 期限 22:12 · ヒット 98%
+RAM █████░░░░░ 23 GB / 48 GB (48%)
+◐ Edit: .../file.ts | ✓ Bash ×12 | ✓ Read ×3
+✓ スキル (2): pinglet, code-review
+◐ Explore [haiku-4.5]: 呼び出し元を探す (12s)
+▸ バグ修正 (2/5)
+~statusline.ts(+39 -11)  ~cli.ts(+15 -5)  +hud.ts(+120)  ?3
+トークン 13.7M (入力: 2k, 出力: 64k, キャッシュ: 13.7M)
+圧縮: 1
+```
+
+キャッシュ行のヒット率は直近リクエストの入力のうちキャッシュから読まれた割合（cache_read / 入力合計）で、キャッシュ期限切れ後に書き直したターンで大きく下がります。prompt cache はカウントダウンではなく期限時刻で表示します。statusline は Claude が動作中にしか再描画されず、
+ターン間では残り時間が止まったまま見えるためです。RAM は Claude プロセスではなく端末全体の値です。
+端末幅を超える行は区切り（`│`, `|`）で次の行に折り返します。
+コンテキスト・使用量・キャッシュは既定で1行にまとめられ（`display.mergeGroups`）、幅が足りなければ自動的に分かれます。
+
+何を・どの順で・何行に表示するかは `pinglet hud` で変更します（Claude Code 内では `/pinglet-hud`）:
+
+```bash
+pinglet hud                            # 現在の設定 + プレビュー
+pinglet hud --preset minimal           # full(すべて) / essential(モデル・プロジェクト・コンテキスト・使用量・キャッシュ・アクティビティ) / minimal(モデル+コンテキスト)
+pinglet hud --layout compact           # 1行にまとめる（expanded は要素ごとに1行）
+pinglet hud --hide usage,todos         # --show で再表示（speed, effort, session-tokens, compactions, git-files なども）
+pinglet hud --order context,project    # 行の順序（省いた要素は非表示）
+pinglet hud --first-line project,model # 1行目のセグメント順
+pinglet hud --off                      # HUD のみオフ（「一緒にコーディング中」の行は残る）
+```
+
+色・しきい値・mergeGroups などの上級キーは `~/.pinglet/config.json` の `"hud"` セクションを直接編集します（キー名は claude-hud と同じです）。
+
 ## 自動アップデート
 
 新しいバージョンが出ると、バックグラウンドで1日1回チェックして自動的に
@@ -73,6 +113,7 @@ statusline の言語はシステム言語に応じて自動選択されます(
 | `pinglet logout` | ログアウト（連携設定・キャッシュは維持） |
 | `pinglet post "メッセージ"` | Ping を送る |
 | `pinglet ping` | いま表示されるメッセージをプレビュー |
+| `pinglet hud [オプション]` | statusline HUD の設定（プリセット・レイアウト・表示要素・順序） |
 | `pinglet doctor` | インストール・接続状態を診断 |
 | `pinglet uninstall` | 設定復元、サーバー上のインストール失効とログアウト |
 
@@ -80,8 +121,11 @@ statusline の言語はシステム言語に応じて自動選択されます(
 
 - **トークン使用量 0** — メッセージは Claude Code の UI 領域（statusline/spinner）にのみ
   表示され、モデルのコンテキストには一切入りません。API コストや応答品質に影響はありません。
-- **コードを読みません** — prompt、応答、コード、環境変数にはアクセスしません。
-  収集するのはインストール ID、OS の種類、クライアントのバージョン、メッセージ表示イベントだけです。
+- **コードを送信しません** — サーバーに送るのはインストール ID、OS の種類、クライアントのバージョン、
+  メッセージ表示イベントだけです。HUD は Claude Code が statusline に渡すセッション指標と、
+  セッション transcript のツール名・対象・todo タイトルを**この端末内でのみ**読んで描画します。
+  prompt・応答本文は保存せず、それらが端末の外に出ることはありません。
+  活動行が不要なら `pinglet hud --hide tools,agents,todos` で transcript を一切読まなくなります。
 - **ターミナルが遅くなりません** — 表示はローカルキャッシュを読むだけで、ネットワークは
   バックグラウンドでのみ使用します。オフラインでも動作します。
 - **すべてのメッセージは審査を通ります** — URL・個人情報・制御文字・不適切な表現は

package/README.ko.md

@@ -58,6 +58,46 @@ pinglet post "메시지"
 
 statusline 언어는 시스템 언어에 따라 자동 선택됩니다(한국어/일본어, 그 외는 영어). 시스템 언어로 판정이 안 되면 타임존(서울/도쿄)으로 추정합니다.
 
+## HUD — 세션 정보를 statusline에
+
+"함께 코딩 중" 줄 아래에 [claude-hud](https://github.com/jarrodwatts/claude-hud)와 같은 방식의 HUD가 표시됩니다.
+모델과 effort 레벨, 프로젝트·git 브랜치(변경 줄 수·푸시 안 한 커밋), `/advisor` 자문 모델, 세션 시간·비용·출력 속도,
+컨텍스트 사용률 바, 5시간/7일/모델별 주간 사용량 한도, prompt cache 만료 시각, 기기 RAM 사용률,
+지금 도는 도구·호출한 스킬·서브 에이전트·todo 진행률, 변경 파일 목록, 세션 누적 토큰, 압축 횟수입니다.
+
+```
+🟢 지금 41개 터미널과 함께 코딩 중
+[Opus 5 ◑ high] │ my-project git:(main* ↑2 [+337 -29]) │ 자문 모델: Opus 4.7 │ ⏱ 56m │ 비용 $1.23 │ 출력: 42.1 tok/s
+컨텍스트 ████░░░░░░ 45% │ 사용량 ███░░░░░░░ 31% (리셋까지 1h 7m) | 주간 █████████░ 85% (리셋까지 2d 7h) │ 캐시 ⏱ 만료 22:12 · 히트 98%
+RAM █████░░░░░ 23 GB / 48 GB (48%)
+◐ Edit: .../file.ts | ✓ Bash ×12 | ✓ Read ×3
+✓ 스킬 (2): pinglet, code-review
+◐ Explore [haiku-4.5]: 호출부 찾기 (12s)
+▸ 버그 수정 (2/5)
+~statusline.ts(+39 -11)  ~cli.ts(+15 -5)  +hud.ts(+120)  ?3
+토큰 13.7M (입력: 2k, 출력: 64k, 캐시: 13.7M)
+압축: 1
+```
+
+캐시 줄의 히트율은 마지막 요청에서 캐시로 읽은 토큰의 비율(cache_read / 전체 입력)이라, 캐시가 만료돼 새로 쓴 턴에서 뚝 떨어집니다. prompt cache는 카운트다운이 아니라 만료 시각으로 보여줍니다. statusline은 Claude가 활동할 때만 다시 그려져서
+턴 사이에는 남은 시간이 멈춘 채 보이기 때문입니다. RAM은 Claude 프로세스가 아니라 기기 전체 수치입니다.
+터미널 폭을 넘는 줄은 구분자(`│`, `|`)에서 다음 줄로 감깁니다.
+컨텍스트·사용량·캐시는 기본적으로 한 줄로 묶이며(`display.mergeGroups`), 폭이 모자라면 자동으로 나뉩니다.
+
+무엇을, 어떤 순서로, 몇 줄에 보여줄지는 `pinglet hud`로 바꿉니다 (Claude Code 안에서는 `/pinglet-hud`):
+
+```bash
+pinglet hud                            # 현재 설정 + 미리보기
+pinglet hud --preset minimal           # full(전부) / essential(모델·프로젝트·컨텍스트·사용량·캐시·활동) / minimal(모델+컨텍스트)
+pinglet hud --layout compact           # 한 줄로 (expanded는 요소마다 한 줄)
+pinglet hud --hide usage,todos         # --show 로 다시 켜기 (speed, effort, session-tokens, compactions, git-files 등)
+pinglet hud --order context,project    # 줄 순서 (뺀 요소는 숨김)
+pinglet hud --first-line project,model # 첫 줄 안의 세그먼트 순서
+pinglet hud --off                      # HUD만 끄기 ("함께 코딩 중" 줄은 유지)
+```
+
+색상·임계값·mergeGroups 같은 고급 키는 `~/.pinglet/config.json`의 `"hud"` 섹션을 직접 편집합니다 (키 이름은 claude-hud와 같습니다).
+
 ## 자동 업데이트
 
 새 버전이 나오면 백그라운드에서 하루 1회 확인해 자동으로 업데이트합니다
@@ -73,6 +113,7 @@ statusline 언어는 시스템 언어에 따라 자동 선택됩니다(한국어
 | `pinglet logout` | 로그인 해제 (설치·캐시는 유지) |
 | `pinglet post "메시지"` | Ping 보내기 |
 | `pinglet ping` | 지금 표시될 메시지 미리보기 |
+| `pinglet hud [옵션]` | statusline HUD 설정 (프리셋·레이아웃·표시 요소·순서) |
 | `pinglet doctor` | 설치·연결 상태 진단 |
 | `pinglet uninstall` | 기존 설정 복원, 서버 설치 폐기 및 로그아웃 |
 
@@ -81,8 +122,11 @@ statusline 언어는 시스템 언어에 따라 자동 선택됩니다(한국어
 - **토큰 사용량 0** — 메시지는 Claude Code의 UI 영역(statusline/spinner)에만
   표시되고 모델 컨텍스트에는 전혀 들어가지 않습니다. API 비용과 응답 품질에
   영향이 없습니다.
-- **코드를 읽지 않습니다** — prompt, 응답, 코드, 환경변수에 접근하지 않습니다.
-  수집하는 것은 설치 ID, OS 종류, 클라이언트 버전, 메시지 노출 이벤트뿐입니다.
+- **코드를 보내지 않습니다** — 서버로 가는 것은 설치 ID, OS 종류, 클라이언트 버전,
+  메시지 노출 이벤트뿐입니다. HUD는 Claude Code가 statusline에 넘기는 세션 지표와
+  세션 transcript의 도구 호출 이름·대상·todo 제목만 **이 기기 안에서** 읽어 그리며,
+  prompt·응답 본문은 저장하지 않고 어떤 것도 서버로 보내지 않습니다.
+  HUD의 활동 줄이 필요 없으면 `pinglet hud --hide tools,agents,todos`로 끄면 transcript를 읽지 않습니다.
 - **터미널이 느려지지 않습니다** — 표시는 로컬 캐시만 읽어서 그리며, 네트워크는
   백그라운드에서만 사용합니다. 오프라인에서도 동작합니다.
 - **모든 메시지는 검수를 거칩니다** — URL·개인정보·제어문자·부적절한 표현은

package/README.md

@@ -58,6 +58,52 @@ The statusline shows how many terminals are coding alongside you right now:
 
 The statusline picks its language from your system language (Korean/Japanese, English otherwise), falling back to your timezone (Seoul/Tokyo) when the language doesn't decide it.
 
+## HUD — session metrics in the statusline
+
+Below the "coding along" line Pinglet renders a HUD that works the same way as
+[claude-hud](https://github.com/jarrodwatts/claude-hud): model and effort level,
+project and git branch (line diff, unpushed commits), the `/advisor` model, session
+duration, cost and output speed, a context-usage bar, 5-hour / 7-day / per-model
+weekly usage limits, the prompt-cache expiry time, machine RAM usage, the tools,
+skills, subagents and todo progress of the current session, changed files, session
+token totals and compaction count.
+
+```
+🟢 coding along with 41 terminals right now
+[Opus 5 ◑ high] │ my-project git:(main* ↑2 [+337 -29]) │ Advisor: Opus 4.7 │ ⏱ 56m │ Cost $1.23 │ out: 42.1 tok/s
+Context ████░░░░░░ 45% │ Usage ███░░░░░░░ 31% (resets in 1h 7m) | Weekly █████████░ 85% (resets in 2d 7h) │ Cache ⏱ until 10:12 PM · hit 98%
+Approx RAM █████░░░░░ 23 GB / 48 GB (48%)
+◐ Edit: .../file.ts | ✓ Bash ×12 | ✓ Read ×3
+✓ Skills (2): pinglet, code-review
+◐ Explore [haiku-4.5]: Find callers (12s)
+▸ Fix the bug (2/5)
+~statusline.ts(+39 -11)  ~cli.ts(+15 -5)  +hud.ts(+120)  ?3
+Tokens 13.7M (in: 2k, out: 64k, cache: 13.7M)
+Compactions: 1
+```
+
+The hit rate on the Cache line is the share of the last request's input that was served from cache (cache_read / total input), so it drops sharply on the turn after the cache expires. The prompt cache shows an expiry time rather than a countdown: the statusline only
+repaints while Claude is active, so a countdown would freeze between turns. RAM is
+the whole machine, not the Claude process. Lines wider than the terminal wrap at
+their separators (`│`, `|`). Context, usage and the cache line share one row by default
+(`display.mergeGroups`) and split apart when the terminal is too narrow.
+
+Choose what to show, in which order and on how many lines with `pinglet hud`
+(`/pinglet-hud` inside Claude Code):
+
+```bash
+pinglet hud                            # current settings + preview
+pinglet hud --preset minimal           # full (everything) / essential (model, project, context, usage, cache, activity) / minimal (model + context)
+pinglet hud --layout compact           # everything on one line (expanded = one line per element)
+pinglet hud --hide usage,todos         # --show to turn them back on (also speed, effort, session-tokens, compactions, git-files, …)
+pinglet hud --order context,project    # line order (omitted elements are hidden)
+pinglet hud --first-line project,model # segment order inside the first line
+pinglet hud --off                      # HUD only; the "coding along" line stays
+```
+
+Advanced keys (colors, thresholds, mergeGroups) live in the `"hud"` section of
+`~/.pinglet/config.json` and use the same names as claude-hud.
+
 ## Auto-update
 
 Pinglet checks for a new version once a day in the background and updates
@@ -73,6 +119,7 @@ left untouched). To opt out, add `"autoUpdate": false` to `~/.pinglet/config.jso
 | `pinglet logout` | Sign out on this machine (keeps the integration and cache) |
 | `pinglet post "message"` | Send a Ping |
 | `pinglet ping` | Preview the message that would be shown now |
+| `pinglet hud [options]` | Configure the statusline HUD (preset, layout, elements, order) |
 | `pinglet doctor` | Diagnose installation and connection status |
 | `pinglet uninstall` | Restore settings, revoke installations and sign out |
 
@@ -81,9 +128,13 @@ left untouched). To opt out, add `"autoUpdate": false` to `~/.pinglet/config.jso
 - **Zero token usage** — messages are shown only in Claude Code's UI area
   (statusline/spinner) and never enter the model context. No impact on API cost
   or response quality.
-- **Never reads your code** — no access to prompts, responses, code, or
-  environment variables. The only data collected: an install ID, OS type,
-  client version, and message-impression events.
+- **Never sends your code** — the only data sent to the server is an install ID,
+  OS type, client version, and message-impression events. The HUD reads the
+  session metrics Claude Code hands to the statusline plus tool names/targets and
+  todo titles from the session transcript, **on this machine only**; prompt and
+  response bodies are never stored and nothing from them leaves your machine.
+  If you don't want the activity lines, `pinglet hud --hide tools,agents,todos`
+  stops the transcript from being read at all.
 - **Doesn't slow down your terminal** — rendering reads only a local cache;
   the network is used in the background only. Works offline too.
 - **Every message is moderated** — URLs, personal information, control

package/dist/adapters/claude.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectClaude = detectClaude;
+exports.ensureSlashCommands = ensureSlashCommands;
 exports.armSpinnerMessage = armSpinnerMessage;
 exports.spinnerVerbsStatus = spinnerVerbsStatus;
 exports.isClaudeIntegrationInstalled = isClaudeIntegrationInstalled;
@@ -53,8 +54,8 @@ const SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
 const COMMANDS_DIR = path.join(CLAUDE_DIR, "commands");
 const COMMAND_MARKER = "generated by pinglet";
 /** 슬래시 명령이 호출하는 CLI 서브커맨드 — 권한 규칙과 command 파일 모두 이 목록 기준. */
-const SLASH_SUBCOMMANDS = ["post", "login", "logout"];
-const COMMAND_FILES = ["pinglet.md", "pinglet-login.md", "pinglet-logout.md"];
+const SLASH_SUBCOMMANDS = ["post", "login", "logout", "hud"];
+const COMMAND_FILES = ["pinglet.md", "pinglet-login.md", "pinglet-logout.md", "pinglet-hud.md"];
 /**
  * Claude Adapter.
  * Claude Code의 statusLine hook에 `pinglet statusline`을 연결한다.
@@ -142,6 +143,17 @@ allowed-tools: Bash(node:*)
 
 Result: !\`node "${cli}" logout\`
 
+Output the result line above exactly as-is, as a single line, without adding or changing anything.
+Do not add any explanation, guidance, or perform any other action.
+`,
+        "pinglet-hud.md": `---
+description: ${(0, i18n_1.t)("slash.hudDesc")}
+allowed-tools: Bash(node:*)
+---
+<!-- ${COMMAND_MARKER} -->
+
+Result: !\`node "${cli}" hud --quiet $ARGUMENTS\`
+
 Output the result line above exactly as-is, as a single line, without adding or changing anything.
 Do not add any explanation, guidance, or perform any other action.
 `,
@@ -150,6 +162,17 @@ Do not add any explanation, guidance, or perform any other action.
         fs.writeFileSync(path.join(COMMANDS_DIR, name), body);
     }
 }
+/**
+ * 누락된 slash command 파일만 채운다 — 자동 업데이트가 postinstall 없이 끝났을 때
+ * 새 명령(`/pinglet-hud` 등)이 생기도록 refresh가 호출한다. 있는 파일은 건드리지 않는다.
+ */
+function ensureSlashCommands(config) {
+    if (!config.adapters.claude)
+        return;
+    const missing = COMMAND_FILES.some((name) => !fs.existsSync(path.join(COMMANDS_DIR, name)));
+    if (missing)
+        installSlashCommand();
+}
 /** Pinglet이 생성한 command 파일만 삭제한다 (마커로 확인). */
 function uninstallSlashCommand() {
     let removed = false;

package/dist/cli.js

@@ -12,6 +12,7 @@ const flush_1 = require("./commands/flush");
 const refresh_1 = require("./commands/refresh");
 const ping_1 = require("./commands/ping");
 const post_1 = require("./commands/post");
+const hud_1 = require("./commands/hud");
 const i18n_1 = require("./i18n");
 const lock_1 = require("./lock");
 const notifications_1 = require("./notifications");
@@ -41,9 +42,17 @@ async function main() {
         case "ping":
             (0, ping_1.runPing)();
             break;
-        case "statusline":
-            (0, statusline_1.runStatusline)();
+        case "hud": {
+            const quiet = rest.includes("--quiet");
+            await (0, hud_1.runHud)(rest.filter((arg) => arg !== "--quiet"), { quiet });
             break;
+        }
+        case "statusline": {
+            const tick = (0, statusline_1.runStatusline)();
+            if (tick)
+                await (0, statusline_1.writeStatusline)(tick);
+            break;
+        }
         case "flush":
             await (0, flush_1.runFlush)();
             break;
@@ -79,11 +88,13 @@ async function dispatch() {
         return;
     }
     if (command === "notify-drain" || command === "statusline") {
-        await (0, lock_1.withPingletLock)(() => {
+        // 잠금은 상태 파일 읽기/쓰기 구간만 보호한다. transcript·git을 읽는 HUD 렌더는 잠금 밖에서.
+        const tick = await (0, lock_1.withPingletLock)(() => {
             (0, notifications_1.drainNotifications)();
-            if (command === "statusline")
-                (0, statusline_1.runStatusline)();
+            return command === "statusline" ? (0, statusline_1.runStatusline)() : undefined;
         }, { skipIfBusy: command === "statusline" });
+        if (tick)
+            await (0, statusline_1.writeStatusline)(tick);
         return;
     }
     if (["--version", "-v", "help", "--help"].includes(command)) {

package/dist/commands/doctor.js

@@ -8,6 +8,7 @@ const queue_1 = require("../queue");
 const claude_1 = require("../adapters/claude");
 const codex_1 = require("../adapters/codex");
 const i18n_1 = require("../i18n");
+const hud_1 = require("../hud");
 const ok = (label) => console.log(`✓ ${label}`);
 const warn = (label) => console.log(`○ ${label}`);
 const bad = (label) => console.log(`✗ ${label}`);
@@ -31,6 +32,8 @@ async function runDoctor() {
             else {
                 warn((0, i18n_1.t)("doctor.spinnerMissing"));
             }
+            const hud = (0, hud_1.loadHudConfig)(config);
+            ok((0, i18n_1.t)("doctor.hud", { enabled: hud.enabled ? "on" : "off", layout: hud.lineLayout }));
         }
         else
             warn((0, i18n_1.t)("doctor.claudeNotInstalled"));

package/dist/commands/hud.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeHudArgs = normalizeHudArgs;
+exports.parseHudArgs = parseHudArgs;
+exports.applyHudArgs = applyHudArgs;
+exports.runHud = runHud;
+const config_1 = require("../config");
+const config_2 = require("../hud/config");
+const hud_1 = require("../hud");
+const i18n_1 = require("../i18n");
+/**
+ * `pinglet hud` — statusline HUD 설정.
+ * claude-hud의 configure 흐름(프리셋 → 끄기/켜기 → 레이아웃)을 플래그로 옮겼다.
+ * 인자 없이 실행하면 현재 설정과 미리보기를 보여준다. `/pinglet-hud`에서도 같은 인자를 받는다.
+ */
+const PRESETS = ["full", "essential", "minimal"];
+function splitList(value) {
+    return (value ?? "").split(/[,\s]+/).map((v) => v.trim()).filter(Boolean);
+}
+function onOff(value) {
+    if (value === "on" || value === "true" || value === "1")
+        return true;
+    if (value === "off" || value === "false" || value === "0")
+        return false;
+    return undefined;
+}
+/** 값을 하나 더 받는 플래그 — 그 뒤 토큰은 값이므로 플래그로 승격하지 않는다. */
+const VALUE_FLAGS = new Set([
+    "--preset", "--layout", "--show", "--hide", "--order", "--first-line", "--path-levels", "--separators", "--git",
+]);
+const FLAG_NAMES = new Set([
+    "preset", "layout", "show", "hide", "order", "first-line", "path-levels", "separators", "git", "on", "off", "reset",
+]);
+const LAYOUTS = new Set(["compact", "expanded"]);
+/**
+ * `--`를 생략한 형태를 받아 준다 — 슬래시 명령(`/pinglet-hud essential`)에서 대시를 붙이는 게
+ * 부자연스럽기 때문이다. `essential` → `--preset essential`, `preset essential` → `--preset essential`,
+ * `compact` → `--layout compact`. 값 자리(예: `--git off`)의 토큰은 그대로 둔다.
+ */
+function normalizeHudArgs(args) {
+    const out = [];
+    for (const arg of args) {
+        const previous = out[out.length - 1];
+        if (previous !== undefined && VALUE_FLAGS.has(previous)) {
+            out.push(arg);
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            out.push(arg);
+            continue;
+        }
+        const bare = arg.replace(/^-+/, "").toLowerCase();
+        if (FLAG_NAMES.has(bare))
+            out.push(`--${bare}`);
+        else if (PRESETS.includes(bare))
+            out.push("--preset", bare);
+        else if (LAYOUTS.has(bare))
+            out.push("--layout", bare);
+        else
+            out.push(arg);
+    }
+    return out;
+}
+function parseHudArgs(rawArgs) {
+    const args = normalizeHudArgs(rawArgs);
+    const parsed = { show: [], hide: [], reset: false, errors: [] };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = () => args[++i];
+        switch (arg) {
+            case "--preset": {
+                const value = next();
+                if (PRESETS.includes(value))
+                    parsed.preset = value;
+                else
+                    parsed.errors.push((0, i18n_1.t)("hud.badPreset", { value: value ?? "" }));
+                break;
+            }
+            case "--layout": {
+                const value = next();
+                if (value === "compact" || value === "expanded")
+                    parsed.layout = value;
+                else
+                    parsed.errors.push((0, i18n_1.t)("hud.badLayout", { value: value ?? "" }));
+                break;
+            }
+            case "--show":
+            case "--hide": {
+                const list = splitList(next());
+                for (const item of list) {
+                    if (!config_2.TOGGLE_KEYS[item])
+                        parsed.errors.push((0, i18n_1.t)("hud.badToggle", { value: item }));
+                    else
+                        (arg === "--show" ? parsed.show : parsed.hide).push(item);
+                }
+                break;
+            }
+            case "--order": {
+                const list = splitList(next());
+                const bad = list.filter((item) => !config_2.KNOWN_ELEMENTS.has(item));
+                if (bad.length > 0 || list.length === 0)
+                    parsed.errors.push((0, i18n_1.t)("hud.badOrder", { value: bad.join(", ") }));
+                else
+                    parsed.order = list;
+                break;
+            }
+            case "--first-line": {
+                const list = splitList(next());
+                const bad = list.filter((item) => !config_2.KNOWN_FIRST_LINE_SEGMENTS.has(item));
+                if (bad.length > 0)
+                    parsed.errors.push((0, i18n_1.t)("hud.badFirstLine", { value: bad.join(", ") }));
+                else
+                    parsed.firstLine = list;
+                break;
+            }
+            case "--path-levels": {
+                const value = next();
+                if (value === "full")
+                    parsed.pathLevels = "full";
+                else if (value === "1" || value === "2" || value === "3")
+                    parsed.pathLevels = Number(value);
+                else
+                    parsed.errors.push((0, i18n_1.t)("hud.badPathLevels", { value: value ?? "" }));
+                break;
+            }
+            case "--separators": {
+                const value = onOff(next());
+                if (value === undefined)
+                    parsed.errors.push((0, i18n_1.t)("hud.badOnOff", { flag: arg }));
+                else
+                    parsed.separators = value;
+                break;
+            }
+            case "--git": {
+                const value = onOff(next());
+                if (value === undefined)
+                    parsed.errors.push((0, i18n_1.t)("hud.badOnOff", { flag: arg }));
+                else
+                    parsed.git = value;
+                break;
+            }
+            case "--on":
+                parsed.enabled = true;
+                break;
+            case "--off":
+                parsed.enabled = false;
+                break;
+            case "--reset":
+                parsed.reset = true;
+                break;
+            case "--quiet":
+                // cli가 이미 걸러 내지만, 사용자가 직접 넘긴 경우에도 오류로 만들지 않는다.
+                break;
+            default:
+                parsed.errors.push((0, i18n_1.t)("hud.unknownArg", { value: arg }));
+        }
+    }
+    return parsed;
+}
+function applyHudArgs(current, parsed) {
+    let hud = parsed.reset ? structuredClone(config_2.DEFAULT_HUD_CONFIG) : structuredClone(current);
+    if (parsed.preset)
+        hud = (0, config_2.applyPreset)(hud, parsed.preset);
+    if (parsed.layout)
+        hud.lineLayout = parsed.layout;
+    for (const item of parsed.show)
+        (0, config_2.setToggle)(hud, item, true);
+    for (const item of parsed.hide)
+        (0, config_2.setToggle)(hud, item, false);
+    if (parsed.order)
+        hud.elementOrder = parsed.order;
+    if (parsed.firstLine)
+        hud.projectLineOrder = parsed.firstLine;
+    if (parsed.pathLevels)
+        hud.pathLevels = parsed.pathLevels;
+    if (parsed.separators !== undefined)
+        hud.showSeparators = parsed.separators;
+    if (parsed.git !== undefined)
+        hud.gitStatus.enabled = parsed.git;
+    if (parsed.enabled !== undefined)
+        hud.enabled = parsed.enabled;
+    return (0, config_2.normalizeHudConfig)(hud);
+}
+/** 미리보기용 가짜 payload — 실제 세션 값이 아니라 설정이 어떻게 보이는지만 확인한다. */
+const PREVIEW_PAYLOAD = {
+    model: { id: "claude-opus-5", display_name: "Opus 5" },
+    cwd: process.cwd(),
+    context_window: { context_window_size: 200_000, used_percentage: 45, current_usage: { input_tokens: 80_000, output_tokens: 10_000 } },
+    cost: { total_cost_usd: 0.42, total_duration_ms: 300_000, total_api_duration_ms: 120_000 },
+    rate_limits: {
+        five_hour: { used_percentage: 25, resets_at: Math.floor(Date.now() / 1000) + 5400 },
+        seven_day: { used_percentage: 10, resets_at: Math.floor(Date.now() / 1000) + 3 * 86_400 },
+    },
+};
+function summary(hud) {
+    const on = Object.entries(config_2.TOGGLE_KEYS)
+        .filter(([, key], index, all) => all.findIndex(([, k]) => k === key) === index)
+        .filter(([, key]) => {
+        const [section, field] = key.split(".");
+        return hud[section][field] === true;
+    })
+        .map(([name]) => name);
+    return [
+        `  enabled:     ${hud.enabled ? "on" : "off"}`,
+        `  layout:      ${hud.lineLayout}${hud.showSeparators ? " (+separators)" : ""}`,
+        `  order:       ${hud.elementOrder.join(", ")}`,
+        `  first line:  ${hud.projectLineOrder.length > 0 ? hud.projectLineOrder.join(", ") : "(default)"}`,
+        `  path levels: ${hud.pathLevels}`,
+        `  git:         ${hud.gitStatus.enabled ? "on" : "off"}`,
+        `  shown:       ${on.join(", ")}`,
+    ].join("\n");
+}
+async function runHud(args, options = {}) {
+    const config = (0, config_1.loadConfig)();
+    const current = (0, config_2.normalizeHudConfig)(config.hud);
+    const parsed = parseHudArgs(args);
+    if (parsed.errors.length > 0) {
+        for (const error of parsed.errors)
+            console.log(`✗ ${error}`);
+        console.log((0, i18n_1.t)("hud.usage"));
+        process.exitCode = 1;
+        return;
+    }
+    const changed = args.length > 0;
+    const next = changed ? applyHudArgs(current, parsed) : current;
+    if (changed) {
+        config.hud = next;
+        (0, config_1.saveConfig)(config);
+    }
+    if (options.quiet) {
+        console.log(changed ? (0, i18n_1.t)("hud.savedQuiet", { layout: next.lineLayout, enabled: next.enabled ? "on" : "off" }) : summary(next).replace(/\n/g, " ·").replace(/\s+/g, " ").trim());
+        return;
+    }
+    console.log("");
+    console.log(changed ? (0, i18n_1.t)("hud.saved") : (0, i18n_1.t)("hud.current"));
+    console.log(summary(next));
+    console.log("");
+    console.log((0, i18n_1.t)("hud.preview"));
+    const lines = await (0, hud_1.renderHudLines)(next, PREVIEW_PAYLOAD);
+    if (lines.length === 0)
+        console.log(`  ${(0, i18n_1.t)("hud.previewEmpty")}`);
+    for (const line of lines)
+        console.log(`  ${line}`);
+    console.log("");
+    if (!changed)
+        console.log((0, i18n_1.t)("hud.usage"));
+}

package/dist/commands/refresh.js

@@ -49,6 +49,12 @@ async function runRefresh() {
     if (!fs.existsSync(config_1.CONFIG_PATH))
         return;
     const config = (0, config_1.loadConfig)();
+    try {
+        (0, claude_1.ensureSlashCommands)(config);
+    }
+    catch {
+        // 명령 파일 보충 실패는 feed 갱신을 막지 않는다.
+    }
     const wanted = [];
     if (config.adapters.claude)
         wanted.push("CLAUDE");