promptbox
도구· Tools
원본 보기

claude-hud

Claude Code로 작업할 때 입력창 바로 아래에 진행 상황 한 줄을 띄워 주는 도구 — 대화가 얼마나 찼는지, 무슨 작업이 도는지, 남은 할 일과 git 변경까지 따로 명령 안 쳐도 한눈에 보인다.

A live status line under your Claude Code prompt that shows how full the chat is, what is running, and your pending tasks at a glance.

#tool#claude-code#plugin#hud#statusline#context-monitor#mit

사용법

How to use
설치 · Install
/plugin marketplace add jarrodwatts/claude-hud && /plugin install claude-hud
언어 · Languages
JavaScriptTypeScript
플랫폼 · Platforms
macOSLinuxWindows
작성자 · Author jarrodwatts 라이선스 · License MIT

한 줄

Claude Code 안에서 /context 따로 안 쳐도 context bar(대화 사용량 막대)가 항상 보이고, 어떤 subagent(보조 에이전트)가 어디까지 갔는지·어떤 파일이 읽히는지·todo(할 일 목록)가 몇 개 남았는지 즉시 보인다.

언제 쓰는가

  • 긴 세션에서 context window(모델이 한 번에 기억하는 한도)가 얼마나 남았는지 계속 신경 쓰일 때
  • subagent를 자주 띄워서 어디가 돌고 있는지 추적이 필요할 때
  • Claude 구독 rate limit(사용량 제한)을 모니터링하고 싶을 때

설치

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup

요구사항: Claude Code v1.0.80+, Node.js 18+ (또는 Bun).

표시 항목

항목내용
Project path디렉터리 깊이 조절 가능
Context healthprogress bar (green → yellow → red)
Tool activity파일 read/edit/search 실시간
Agent tracking실행 중 subagent와 상태
Todo progresstask 완료 카운트
Git statusbranch + uncommitted 변경
Usage limitsClaude 구독 rate limit

함정

  • Claude Code 버전이 낮으면 statusline API가 달라 작동 안 함 — 반드시 1.0.80 이상
  • 설치 직후 /reload-plugins와 /claude-hud:setup 둘 다 거쳐야 정상 활성화
  • HUD가 너무 많은 행을 차지하면 /claude-hud:configure에서 표시 항목 토글
## 한 줄

Claude Code 안에서 `/context` 따로 안 쳐도 context bar(대화 사용량 막대)가 항상 보이고, 어떤 subagent(보조 에이전트)가 어디까지 갔는지·어떤 파일이 읽히는지·todo(할 일 목록)가 몇 개 남았는지 즉시 보인다.

## 언제 쓰는가

- 긴 세션에서 context window(모델이 한 번에 기억하는 한도)가 얼마나 남았는지 계속 신경 쓰일 때
- subagent를 자주 띄워서 어디가 돌고 있는지 추적이 필요할 때
- Claude 구독 rate limit(사용량 제한)을 모니터링하고 싶을 때

## 설치

```text
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup
```

요구사항: Claude Code v1.0.80+, Node.js 18+ (또는 Bun).

## 표시 항목

| 항목 | 내용 |
|------|------|
| Project path | 디렉터리 깊이 조절 가능 |
| Context health | progress bar (green → yellow → red) |
| Tool activity | 파일 read/edit/search 실시간 |
| Agent tracking | 실행 중 subagent와 상태 |
| Todo progress | task 완료 카운트 |
| Git status | branch + uncommitted 변경 |
| Usage limits | Claude 구독 rate limit |

## 함정

- Claude Code 버전이 낮으면 statusline API가 달라 작동 안 함 — 반드시 1.0.80 이상
- 설치 직후 `/reload-plugins`와 `/claude-hud:setup` 둘 다 거쳐야 정상 활성화
- HUD가 너무 많은 행을 차지하면 `/claude-hud:configure`에서 표시 항목 토글