RunCat Neo 顯示 Claude Code 與 Codex 用量：Desktop 排錯與設定

1
Claude Code status line／Codex hook／launchd
2
                    ↓
3
              更新本機 JSON
4
                    ↓
5
        RunCat Neo 監看檔案變化
6
                    ↓
7
          Dashboard／Metrics Bar

1
{
2
  "statusLine": {
3
    "type": "command",
4
    "command": "/Users/你的帳號/.claude/runcat-statusline.py"
5
  }
6
}

1
{
2
  "hooks": {
3
    "Stop": [
4
      {
5
        "hooks": [
6
          {
7
            "type": "command",
8
            "command": "/Users/你的帳號/.codex/runcat-hook.py",
9
            "timeout": 5
10
          }
11
        ]
12
      }
13
    ]
14
  }
15
}

1
#!/usr/bin/env python3
2
import json
3
import os
4
import tempfile
5
from datetime import datetime, timezone
6
from pathlib import Path
7

8
sessions = Path.home() / ".codex" / "sessions"
9
output = Path.home() / ".codex" / "runcat-usage.json"
10

11
files = list(sessions.rglob("*.jsonl"))
12
if not files:
13
    raise SystemExit(0)
14

15
transcript = max(files, key=lambda path: path.stat().st_mtime)
16
model = "Codex Desktop"
17
token_count = None
18

19
with transcript.open(encoding="utf-8") as source:
20
    for line in source:
21
        try:
22
            event = json.loads(line)
23
        except json.JSONDecodeError:
24
            continue
25
        payload = event.get("payload") or {}
26
        if event.get("type") == "turn_context" and payload.get("model"):
27
            model = payload["model"]
28
        if payload.get("type") == "token_count":
29
            token_count = payload
30

31
metrics = [{"title": "Model", "formattedValue": model}]
32
bar_value = None
33
info = (token_count or {}).get("info") or {}
34
usage = (info.get("last_token_usage") or {}).get("total_tokens")
35
window = info.get("model_context_window")
36

37
if isinstance(usage, (int, float)) and isinstance(window, (int, float)) and window > 0:
38
    percent = max(0, min(100, usage / window * 100))
39
    bar_value = f"{percent:.1f}%"
40
    metrics.append({
41
        "title": "Context",
42
        "formattedValue": bar_value,
43
        "normalizedValue": round(percent / 100, 4),
44
    })
45

46
resets = []
47
rate_limits = (token_count or {}).get("rate_limits") or {}
48
for key in ("primary", "secondary"):
49
    limit = rate_limits.get(key) or {}
50
    minutes = limit.get("window_minutes")
51
    used = limit.get("used_percent")
52
    reset = limit.get("resets_at")
53
    if isinstance(minutes, (int, float)) and isinstance(used, (int, float)):
54
        title = f"{minutes / 1440:g}d" if minutes % 1440 == 0 else f"{minutes / 60:g}h"
55
        metrics.append({
56
            "title": title,
57
            "formattedValue": f"{used:g}%",
58
            "normalizedValue": round(max(0, min(100, used)) / 100, 4),
59
        })
60
    if isinstance(reset, (int, float)):
61
        resets.append(reset)
62

63
if resets:
64
    reset_at = datetime.fromtimestamp(min(resets)).astimezone()
65
    metrics.append({"title": "Full reset", "formattedValue": reset_at.strftime("%m/%d %H:%M")})
66

67
snapshot = {
68
    "title": "Codex",
69
    "symbol": "camera.aperture",
70
    "metrics": metrics,
71
    "lastUpdatedDate": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
72
}
73
if bar_value:
74
    snapshot["metricsBarValue"] = bar_value
75

76
output.parent.mkdir(parents=True, exist_ok=True)
77
fd, temporary = tempfile.mkstemp(prefix=".runcat-", dir=output.parent)
78
with os.fdopen(fd, "w", encoding="utf-8") as target:
79
    json.dump(snapshot, target, ensure_ascii=False)
80
os.replace(temporary, output)

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
<plist version="1.0">
4
<dict>
5
  <key>Label</key>
6
  <string>dev.runcat.codex-refresh</string>
7
  <key>ProgramArguments</key>
8
  <array>
9
    <string>/usr/bin/python3</string>
10
    <string>/Users/你的帳號/.codex/runcat-refresh.py</string>
11
  </array>
12
  <key>StartInterval</key>
13
  <integer>30</integer>
14
  <key>RunAtLoad</key>
15
  <true/>
16
</dict>
17
</plist>

1
Settings → Metrics → Custom Metrics → Add JSON Source

1
~/.claude/runcat-usage.json
2
~/.codex/runcat-usage.json