claude-code-hud 0.3.2 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +34 -5
- package/package.json +3 -2
- package/tui/hud.tsx +1 -0
package/README.md
CHANGED
|
@@ -59,9 +59,6 @@ npx claude-code-hud
|
|
|
59
59
|
# 전역 설치
|
|
60
60
|
npm install -g claude-code-hud
|
|
61
61
|
claude-hud
|
|
62
|
-
|
|
63
|
-
# Claude Code 플러그인
|
|
64
|
-
/plugin install letsgojh0810/hud-plugin
|
|
65
62
|
```
|
|
66
63
|
|
|
67
64
|
### 기능
|
|
@@ -117,6 +114,23 @@ claude-hud
|
|
|
117
114
|
- Claude Pro / Max 플랜 권장 (5h / 주간 사용률 표시)
|
|
118
115
|
- Git (GIT 탭 사용 시)
|
|
119
116
|
|
|
117
|
+
### 플랫폼 지원
|
|
118
|
+
|
|
119
|
+
| 기능 | macOS | Windows |
|
|
120
|
+
|------|-------|---------|
|
|
121
|
+
| 기본 실행 | ✅ | ✅ Node.js 설치 후 `npx` |
|
|
122
|
+
| 토큰 / Git / 파일 브라우저 | ✅ | ✅ |
|
|
123
|
+
| 5h / 주간 사용률 | ✅ Keychain 자동 인식 | ⚠️ `~/.claude/.credentials.json` 폴백 |
|
|
124
|
+
| 터미널 렌더링 | ✅ | ✅ Windows Terminal 권장 (cmd.exe 깨짐) |
|
|
125
|
+
| 한글 키보드 | ✅ | ⚠️ IME 방식 차이로 미지원 가능 |
|
|
126
|
+
|
|
127
|
+
**Windows 권장 환경:**
|
|
128
|
+
- [Windows Terminal](https://aka.ms/terminal) 사용
|
|
129
|
+
- WSL2 환경이면 macOS와 동일하게 동작
|
|
130
|
+
|
|
131
|
+
**Windows에서 5h/wk 사용률이 안 보일 때:**
|
|
132
|
+
Claude Code를 한 번 실행하면 `~/.claude/.credentials.json`에 credentials이 저장됩니다. HUD는 이 파일을 자동으로 읽습니다.
|
|
133
|
+
|
|
120
134
|
---
|
|
121
135
|
|
|
122
136
|
## English
|
|
@@ -157,8 +171,6 @@ npx claude-code-hud
|
|
|
157
171
|
npm install -g claude-code-hud
|
|
158
172
|
claude-hud
|
|
159
173
|
|
|
160
|
-
# Claude Code plugin
|
|
161
|
-
/plugin install letsgojh0810/hud-plugin
|
|
162
174
|
```
|
|
163
175
|
|
|
164
176
|
### Features
|
|
@@ -198,6 +210,23 @@ claude-hud
|
|
|
198
210
|
|
|
199
211
|
> Korean keyboard layout supported — `ㅓ/ㅏ` (j/k), `ㅇ` (d), `ㄱ` (r), `ㅂ` (q), `ㅠ` (b)
|
|
200
212
|
|
|
213
|
+
### Platform Support
|
|
214
|
+
|
|
215
|
+
| Feature | macOS | Windows |
|
|
216
|
+
|---------|-------|---------|
|
|
217
|
+
| Basic run | ✅ | ✅ via `npx` with Node.js |
|
|
218
|
+
| Tokens / Git / File browser | ✅ | ✅ |
|
|
219
|
+
| 5h / weekly usage % | ✅ Keychain auto-detected | ⚠️ Falls back to `~/.claude/.credentials.json` |
|
|
220
|
+
| Terminal rendering | ✅ | ✅ Windows Terminal recommended (cmd.exe may break) |
|
|
221
|
+
| Korean keyboard | ✅ | ⚠️ May not work depending on IME |
|
|
222
|
+
|
|
223
|
+
**Windows recommendations:**
|
|
224
|
+
- Use [Windows Terminal](https://aka.ms/terminal) for proper Unicode rendering
|
|
225
|
+
- WSL2 works identically to macOS
|
|
226
|
+
|
|
227
|
+
**5h / weekly usage not showing on Windows?**
|
|
228
|
+
Run `claude` once to authenticate — credentials are saved to `~/.claude/.credentials.json` which the HUD reads automatically.
|
|
229
|
+
|
|
201
230
|
### How it works
|
|
202
231
|
|
|
203
232
|
- **Token data**: Watches `~/.claude/projects/*/sessions/*.jsonl` with chokidar — updates instantly on each Claude response
|
package/package.json
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-code-hud",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.4",
|
|
4
4
|
"description": "Terminal HUD for Claude Code — real-time token usage, git status, project monitor",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
|
-
"claude-hud": "./bin/claude-hud.js"
|
|
7
|
+
"claude-hud": "./bin/claude-hud.js",
|
|
8
|
+
"claude-code-hud": "./bin/claude-hud.js"
|
|
8
9
|
},
|
|
9
10
|
"keywords": [
|
|
10
11
|
"claude",
|