setup

claude-mini-hud Setup

把 claude-mini-hud 配成 Claude Code 的 statusline, 让 ~/.claude/settings.json 里的 statusLine.command 指向本插件的 dist/index.js。

Step 1: 选择语言 / Select Language

必须先调用 AskUserQuestion 弹出语言选择菜单, 根据用户选择决定后续步骤里的提示文案 + 写入 settings.json 的环境变量:

Use AskUserQuestion:
  header: "Language"
  question: "请选择显示模式 / Select display mode"
  options:
    - label: "中文 (Chinese)"
      description: "上下文 + Token + 当前任务 全部中文"
    - label: "English"
      description: "Context + Token + Todos 全部英文"
    - label: "简约 (Minimal)"
      description: "英中混搭, 无前缀符号, 最紧凑布局"
    - label: "极简 (Ultra-Minimal)"
      description: "只显示 Context + Token 两行, 其余全部隐藏"

把用户选择存到 {LANG} 变量 (zh / en / minimal / ultra-minimal), 后续步骤用它:

1. 决定 Step 6 输出提示的语种
2. 写入 statusLine.command 的 CLAUDE_MINI_HUD_LANG={LANG} 环境变量

4 种模式输出示例 (支持 emoji 的终端会自动显示 emoji 图标, 不支持的终端显示 ASCII 符号):

# 中文 (zh) — emoji 终端
📊 上下文 ███░░░░░░░░░░░░░░░░░ 13%  100k / 1M  剩余 900k
🪙 Token 23k (in 22k · out 342 · cache 768)
▶ 当前任务 调研充电行业政策  (2/5)

# 中文 (zh) — 无 emoji 终端
# 上下文 ███░░░░░░░░░░░░░░░░░ 13%  100k / 1M  剩余 900k
$ Token 23k (in 22k · out 342 · cache 768)
> 当前任务 调研充电行业政策  (2/5)

# English (en) — emoji 终端
📊 Context ███░░░░░░░░░░░░░░░░░ 13%  100k / 1M  left 900k
🪙 Token 23k (in 22k · out 342 · cache 768)
▶ Todos Research charging industry policy  (2/5)

# 简约 (minimal) — 无 emoji, 无前缀
 Context ███░░░░░░░░░░░░░░░░░ 13%  100k / 1M  剩余 900k
 Token 23k (in 22k · out 342 · cache 768)
 当前任务 调研充电行业政策  (2/5)

# 极简 (ultra-minimal) — 只显示两行
 Context ███░░░░░░░░░░░░░░░░░ 13%  100k / 1M  剩余 900k
 Token 23k (in 22k · out 342 · cache 768)

Step 1.5: 选择主题风格 (可选)

调用 AskUserQuestion 弹出主题选择菜单:

Use AskUserQuestion:
  header: "Theme"
  question: "选择进度条风格 / Select progress bar theme"
  options:
    - label: "经典 Classic (默认)"
      description: "███░░░░░░░░  经典实心方块"
    - label: "霓虹 Neon"
      description: "⟦ CTX: ▓▓▓▓░░░░ ⟧  霓虹矩阵风"
    - label: "点阵 Braille"
      description: "⣿⣷⣯⣟░░░░  Braille 点阵"
    - label: "硬核 Hardcore"
      description: "[■■■□□□□□] CTX │  硬核风"