cc-plus

name	cc-plus
description	Set up a Claude Code custom status line (with an optional ASCII buddy/pet easter-egg) AND completion notification sound on Windows or macOS. Use when configuring statusLine in settings.json, when bash/jq/Unicode errors occur, when the user wants a sound alert when Claude finishes a response, or when adding a status-bar pet/companion. Auto-detects OS and Python vs Node.js runtime.

Status Line & Notification Setup (Windows / macOS)

Claude: Follow these steps in order

---

Step 1 — Detect OS and runtime

Detect OS — run the appropriate command based on what shell is available:

# Mac / Linux
uname -s        # returns "Darwin" on Mac

# Windows
$env:OS         # returns "Windows_NT"

Set OS to windows or mac for use in later steps.

Detect runtime — check in order of preference:

Command	Check
python3 --version	Mac preferred
python --version	Windows preferred
node --version	Fallback for both

• Python available → use scripts/statusline.py, command = python3 (Mac) or python (Windows)
• Node.js only → use scripts/statusline.js, command = node
• Neither → tell user to install Node.js and re-run

Get home directory:

• Mac: echo $HOME → e.g. /Users/alice
• Windows: $env:USERPROFILE → e.g. C:\Users\alice

---

Step 2 — Ask user preferences with AskUserQuestion

Call AskUserQuestion with these two questions:

Q1: "Claude 完成响应后播放提示音？" (header: "提示音")

• 叮咚 Ding — 清脆短促（Mac: Glass / Windows: ding.wav）(Recommended)
• 铃声 Chime — 较悠长（Mac: Tink / Windows: chimes.wav）
• 蜂鸣 Beep — 系统蜂鸣，无需声卡
• 不播放 — 仅配置状态栏

Q2: "上下文用量警告阈值？" (header: "警告阈值")

• 80% 警告 / 95% 危险 (Recommended)
• 70% 警告 / 90% 危险
• 60% 警告 / 85% 危险

---

Step 3 — Copy script to ~/.claude/

Copy the chosen script:

• Python: scripts/statusline.py → ~/.claude/statusline.py
• Node.js: scripts/statusline.js → ~/.claude/statusline.js

---

Step 4 — Build the sound command

Mac (afplay is built-in, no dependencies):

Choice	Command
叮咚 Ding	afplay /System/Library/Sounds/Glass.aiff
铃声 Chime	afplay /System/Library/Sounds/Tink.aiff
蜂鸣 Beep	osascript -e 'beep'

Windows (powershell is always available):

Choice	Command
叮咚 Ding	powershell -WindowStyle Hidden -NonInteractive -c "[System.Media.SoundPlayer]::new('C:\\Windows\\Media\\ding.wav').PlaySync()"
铃声 Chime	powershell -WindowStyle Hidden -NonInteractive -c "[System.Media.SoundPlayer]::new('C:\\Windows\\Media\\chimes.wav').PlaySync()"
蜂鸣 Beep	powershell -WindowStyle Hidden -NonInteractive -c "[Console]::Beep(880,200)"

---

Step 5 — Update ~/.claude/settings.json

Read the existing file, then merge these fields (preserve any existing keys):

"statusLine": {
  "type": "command",
  "command": "<runtime> <home>/.claude/statusline.<ext>"
},
"hooks": {
  "Stop": [
    {
      "matcher": "",
      "hooks": [
        {
          "type": "command",
          "command": "<sound-command-from-step-4>"
        }
      ]
    }
  ]
}

• If user chose 不播放: omit the hooks block (preserve any pre-existing hooks)
• If hooks.Stop already exists: append to the array, do not replace
• Windows paths in command: use forward slashes (C:/Users/...) — Claude Code handles both

---

Step 6 — Verify

Test the script:

# Mac / Linux
echo '{"model":{"display_name":"Sonnet 4.6"},"context_window":{"used_percentage":25},"cost":{"total_cost_usd":0.05},"rate_limits":{"five_hour":{"used_percentage":10},"seven_day":{"used_percentage":30}}}' | python3 ~/.claude/statusline.py

# Windows (Node.js)
echo '{"model":{"display_name":"Sonnet 4.6"},"context_window":{"used_percentage":25},"cost":{"total_cost_usd":0.05},"rate_limits":{"five_hour":{"used_percentage":10},"seven_day":{"used_percentage":30}}}' | node "$env:USERPROFILE/.claude/statusline.js"

Tell the user setup is complete and what the status bar will look like.

---

Status Bar Output Format

Sonnet 4.6  ctx [████░░░░░░░░░░░░] 25%  $0.050  5h:10%  7d:30%  (·oo·)

Color coding (using chosen thresholds):

• Green — below warn threshold
• Yellow — warn to danger
• Red — at or above danger threshold

---

Buddy 宠物 (彩蛋)

状态栏行尾住着一只金色的传说级卡皮巴拉 —— Claude Code 内置 companion 彩蛋的移植版。单行、无字，但它活着：每次状态栏刷新都会换一个姿态，靠「当前时间」驱动待机动画、靠「会话状态」决定心情和偶发反应。固定一只，已内建在两个脚本里，无需任何配置。

待机动画（时间驱动，刷新之间持续微动）：

• 嘴在咀嚼：oo → Oo → oO 循环
• 偶尔眨眼：(^oo^) → (-oo-) 一闪

心情（眼睛随 ctx 上下文用量变化）：

ctx	眼睛	状态
< 50%	^	开心 (^oo^)
50–WARN	·	清醒 (·oo·)
WARN–DANGER	-	疲惫 (-oo-)
≥ DANGER	×	累瘫 (×oo×)

偶发反应（按会话状态，时不时冒一个符号 + 一句暖心/俏皮的话，不是常驻；话语从短语池里随时间轮换，所以每次不一样）：

符号	触发	短语池（卡皮巴拉淡定治愈风）
♥♥♥	ctx 宽裕时	you got this / we're vibing / proud of you / …
~~~	随机	la la la~ / just chillin' / doot doot doot / …
zzz	ctx ≥ WARN	5 more minutes / so very sleepy / ok... carry on / …
$$$	花费 ≥ $1	worth every cent / treat yourself / ooh, fancy / …
!!!	限额 ≥ 90%	breathe, you ok? / ease up soon / take a lil break / …

例：(^oo^) ♥♥♥ you got this、(-Oo-) zzz 5 more minutes、(×oo×) !!! breathe, you ok?

符号金色醒目，话语用暗色柔和呈现，不抢状态栏其它信息。短语想改/想加，直接编辑脚本里的 QUIPS 即可。

调试：设环境变量 BUDDY_NOW=<整数> 可固定动画相位，方便预览各帧。

容错设计：宠物逻辑出错时静默隐藏，绝不影响状态栏其余部分。

---

Available JSON Fields Reference

Field	Description
model.display_name	e.g. "Sonnet 4.6"
context_window.used_percentage	0–100 float
cost.total_cost_usd	Session cumulative cost USD
rate_limits.five_hour.used_percentage	5-hour API quota % used
rate_limits.five_hour.resets_at	Unix timestamp (seconds) when 5-hour window resets
rate_limits.seven_day.used_percentage	7-day API quota % used
rate_limits.seven_day.resets_at	Unix timestamp (seconds) when 7-day window resets

Debugging: Dump Raw JSON

Temporarily add to the script to see all available fields:

# Python — add after sys.stdout line
import os
raw = sys.stdin.read()
with open(os.path.expanduser("~/.claude/statusline_debug.json"), "w") as f:
    f.write(raw)
data = json.loads(raw)

// Node.js — add inside stdin 'end' handler before JSON.parse
const fs = require('fs'), os = require('os');
fs.writeFileSync(os.homedir() + '/.claude/statusline_debug.json', raw);

Platform Notes

Windows Unicode fix (Python only) — required to prevent cp1252 encoding errors with █ ░:

sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

Safe to include on macOS too (no-op since UTF-8 is already default).

Why not bash + jq on Windows:

• jq not bundled with Git Bash — requires admin rights via Chocolatey
• Python/Node.js solve Unicode and dependency issues on both platforms