hud 실행 화면

hud

hud · by hoobnn

모델·프로젝트·Git·컨텍스트·사용량·도구·할 일을 HUD 한 줄로 표시해요. 예산·이력·작업 요약·상세 패널·테마도 지원해요.

❯ /plugin marketplace add SeongGwangJu/k-mods
❯ /plugin install hud@k-mods

이미 열려 있는 세션에는 /reload-plugins로 바로 적용돼요. Claude Code 2.1.287 이상이 필요해요.

알아 둘 점

  • [jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud) 0.10.0을 mod로 옮긴 것으로, 별도 LICENSE.claude-hud(MIT, Jarrod Watts)로 원저작권을 유지해요. 화면 언어는 k-mods의 /config가 아니라 claude-hud 자신의 설정 파일(~/.claude/plugins/claude-hud/config.json 또는 ~/.claude/claude-hud.json)의 language 필드를 따라요(기본값 en). plugin.json userConfig에 language 옵션 자체가 없어 여기서는 language 설정을 권장하지 않았어요.
  • summaryEveryTurns(기본 5턴, 0으로 끌 수 있음)마다 세션 작업을 한 줄로 요약하는 모델 호출이 있어요. 대화를 포크해 프롬프트 캐시를 재사용하는 호출이라 비용은 적지만 사용자 사용량을 소모해요.
  • extraCmd(claude-hud의 --extra-cmd, 임의 쉘 명령 실행)는 기본 빈 값이고, 쓰려면 옵션 설정과 CLAUDE_HUD_ALLOW_EXTRA_CMD=1 환경 변수를 모두 켜야 해요.
  • 계정 인증 방식·이메일 일부를 보여주는 기능(claude-hud의 showAuth/showAuthUser)과 다른 로컬 도구로 사용량을 공유하는 파일(externalUsagePath/externalUsageWritePath)은 claude-hud 자체 설정 파일에서만 켤 수 있고 둘 다 기본값이 꺼짐이에요.
  • 같은 작성자(hoobnn)의 원본 spinner mod와 함께 쓰면 pet이 HUD 옆(below 위치일 때)에 표시돼요. k-mods의 pixel-pals와는 연동되지 않고, 없어도 정상 동작해요.

준비물

  • Nerd Font (nerd·powerline 테마에서만 필요)

이 mod가 내 컴퓨터에서 하는 일

mod는 샌드박스 없이 내 권한으로 실행돼요. 정적 분석으로 확인한 범위예요.

프로그램 실행파일 쓰기모델 호출도구 호출 제어대화 읽기환경·설정 읽기파일 읽기소리
정적 분석 결과

다루는 이벤트

command.runcommand.run{command=hud}prompt.editprompt.submitsession.attachsession.compactsession.detachsession.measuresession.receivesession.startstate.set{plugin=spinner, key=dock}tool.calltool.call{tool=/"^mcp__hud__hud_debug$"/}turn.completeturn.startturn.stepui.messageui.render{component=AbovePrompt}ui.render{component=Pane, requestId=hud-detail}ui.render{component=PromptHint}ui.render{component=SessionMode}