Terminal HUD for Claude Code — real-time token, cost, git, and project monitor
npx claudepluginhub letsgojh0810/hud-pluginTerminal HUD for Claude Code — real-time token, cost, git, and project monitor
Claude Code로 작업할 때 토큰 사용량, git 상태, 파일 구조, 세션 히스토리를 IDE나 별도 툴 없이 터미널 하나에서 확인할 수 있는 HUD입니다.
<img src="./capture.png" width="700" alt="side-by-side demo">터미널 두 개를 열고 같은 프로젝트 디렉토리에서 실행하면 됩니다.
터미널 A 터미널 B
───────────────────────────── ─────────────────────────────
cd ~/my-project cd ~/my-project
claude npx claude-code-hud
(Claude Code 작업 중...) (HUD 실시간 표시)
HUD는 현재 디렉토리를 기준으로 토큰, git, 프로젝트 정보를 자동으로 인식합니다.
# tmux로 한 화면에서 split
cd ~/my-project
tmux split-window -h "npx claude-code-hud"
# 방법1. 전역 설치 (권장)
> npm install -g claude-code-hud
> claude-hud
# 방법2. 설치 없이 바로 실행
> npx claude-code-hud
1 TOKENS 탭
1h 23m 형식으로 리셋까지 남은 시간 표시now — 현재 진행 중인 작업 (직접 입력한 마지막 프롬프트) 한 줄 표시2 PROJECT 탭 — 인터랙티브 파일 브라우저
▸ TREE │ ▸ SOURCE src/index.ts
▼ src/ 23f │ 1 import React from 'react'
▼ components/ 8f │ 2 import { render } from 'ink'
Header.tsx M │ 3
▶ hooks/ 4f │ 4 render(<App />)
▶ scripts/ 6f │ … [j/k] scroll [esc] close
3 GIT 탭
b 키로 로컬 브랜치 목록 표시, 선택해서 바로 checkout4 TIMELINE 탭
| 키 | 동작 |
|---|---|
1 2 3 4 | 탭 전환 |
j / k | 스크롤 / 트리 이동 |
→ / Enter | 디렉토리 펼치기 / 파일 열기 |
← / Esc | 접기 / 소스 뷰어 닫기 |
b | 브랜치 전환 (GIT 탭) |
d | 액센트 색상 변경 (blue → red → amber → green → pink) |
r | 수동 새로고침 |
q | 종료 |
한글 키보드 모드에서도 동작합니다 —
ㅓ/ㅏ(j/k),ㅇ(d),ㄱ(r),ㅂ(q),ㅠ(b)
| 기능 | macOS | Windows |
|---|---|---|
| 기본 실행 | ✅ | ✅ Node.js 설치 후 npx |
| 토큰 / Git / 파일 브라우저 | ✅ | ✅ |
| 5h / 주간 사용률 | ✅ Keychain 자동 인식 | ⚠️ ~/.claude/.credentials.json 폴백 |
| 터미널 렌더링 | ✅ | ✅ Windows Terminal 권장 (cmd.exe 깨짐) |
| 한글 키보드 | ✅ | ⚠️ IME 방식 차이로 미지원 가능 |
Windows 권장 환경:
Windows에서 5h/wk 사용률이 안 보일 때:
Claude Code를 한 번 실행하면 ~/.claude/.credentials.json에 credentials이 저장됩니다. HUD는 이 파일을 자동으로 읽습니다.
A Terminal HUD (Heads-Up Display) for Claude Code — real-time token usage, git status, interactive project file browser, and session history. No IDE, no extra tabs. Just a second terminal window.
<img src="./capture.png" width="700" alt="side-by-side demo">Open two terminals in the same project directory.
Terminal A Terminal B
───────────────────────────── ─────────────────────────────
cd ~/my-project cd ~/my-project
claude npx claude-code-hud
(working with Claude Code) (HUD live display)
# tmux split pane
cd ~/my-project
tmux split-window -h "npx claude-code-hud"
# Option 1. Global install (recommended)
> npm install -g claude-code-hud
> claude-hud
# Option 2. Run directly without install
> npx claude-code-hud
1 TOKENS tab
1h 23mnow line — last prompt you typed (not tool results)2 PROJECT tab — interactive file browser
package.json