Repolode
jazzenchen

jazzenchen/agent-hud-open

Claude Code, Codex와 16개의 다른 코딩 에이전트의 할당량, 토큰 사용량, 세션을 보여주고, 요청 승인과 원클릭 세션 복귀를 지원하는 macOS HUD입니다.

스타
129
포크
24
열린 이슈
4
마지막 커밋
5시간 전

어떤 프로젝트인가요?

Agent HUD는 AI 코딩 에이전트를 위한 헤드업 디스플레이입니다. Mac 화면 가장자리나 노치에 표시하거나 플로팅 패널로 띄울 수 있으며, 각 에이전트의 할당량, 잔액, 토큰 사용량과 활성 세션을 한곳에서 보여줍니다. 가장 많이 사용된 할당량의 소진 정도를 색상으로 표시해 어떤 에이전트가 작업 중인지, 완료됐는지, 대기 중인지 한눈에 확인할 수 있습니다.

HUD에서 에이전트의 요청과 질문을 승인하거나 거부하고 답변할 수 있으며, 클릭 한 번으로 세션의 스레드, 탭 또는 터미널 창으로 돌아갈 수 있습니다. 토큰 사용량은 에이전트, 모델, 세션, 토큰 종류별로 확인할 수 있고, 기간은 5시간부터 30일까지 설정할 수 있습니다. 기록은 SQLite에 로컬로 저장됩니다. 비용은 정가 기준 추정치로 표시됩니다.

Rust 코어는 Tauri 2와 React 인터페이스로 구성되어 있습니다. 현재 지원 플랫폼은 macOS이며, Windows와 Linux 빌드는 프리뷰 단계입니다. 함께 제공되는 iPhone 및 Apple Watch 앱 Agent HUD Remote는 iCloud를 통해 동기화됩니다. 이 프로젝트는 Apache-2.0 라이선스를 따릅니다.

핵심 기능

  • 01Claude Code, Codex 및 여러 다른 에이전트의 할당량, 잔액과 토큰 사용량을 표시
  • 02색상으로 표시되는 화면 가장자리 빛으로 작업 중이거나 완료됐거나 할당량이 부족한 에이전트를 알려줌
  • 03HUD에서 에이전트의 도구 요청과 질문을 승인하거나 거부하고 답변
  • 04클릭 한 번으로 세션의 스레드, 탭 또는 터미널 창으로 복귀
  • 05에이전트, 모델, 세션, 토큰 종류별 토큰 사용량을 분석하고 로컬에 저장
  • 06에이전트가 HUD 레이아웃을 조정하고 사용량 데이터를 조회할 수 있는 내장 MCP 서버

활용 사례

  • Mac에서 여러 코딩 에이전트를 동시에 실행하며 상태 확인
  • 할당량 소진 속도를 살펴 작업 도중 한도에 도달하지 않도록 관리
  • 토큰과 비용을 가장 많이 사용한 모델 및 세션 확인
  • 자리를 비운 동안 휴대폰이나 시계에서 에이전트 작업 승인

빠른 시작

  1. 1

    Mac에 Homebrew로 설치

    brew install --cask jazzenchen/tap/agent-hud
  2. 2

    또는 Mac, Windows, Linux에 Node.js로 설치

    npx @agenthud/install

사용 전 알아둘 점

  • 전체 앱은 macOS 12 이상에서 실행됩니다. Windows와 Linux는 프리뷰 버전이며 실제 기기에서 아직 검증되지 않았습니다.
  • Agent HUD Remote를 통한 iPhone 및 Apple Watch 지원은 Mac과 iCloud가 있는 경우에만 작동합니다.

포함된 컬렉션

토픽

자주 묻는 질문

agent-hud-open은(는) 무엇인가요?
Claude Code, Codex와 16개의 다른 코딩 에이전트의 할당량, 토큰 사용량, 세션을 보여주고, 요청 승인과 원클릭 세션 복귀를 지원하는 macOS HUD입니다. Agent HUD는 AI 코딩 에이전트를 위한 헤드업 디스플레이입니다. Mac 화면 가장자리나 노치에 표시하거나 플로팅 패널로 띄울 수 있으며, 각 에이전트의 할당량, 잔액, 토큰 사용량과 활성 세션을 한곳에서 보여줍니다. 가장 많이 사용된 할당량의 소진 정도를 색상으로 표시해 어떤 에이전트가 작업 중인지, 완료됐는지, 대기 중인지 한눈에 확인할 수 있습니다.
agent-hud-open은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agent-hud-open은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agent-hud-open은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agent-hud-open의 마지막 커밋은 2026년 11월 7일입니다.
agent-hud-open은(는) 어디에 사용할 수 있나요?
Mac에서 여러 코딩 에이전트를 동시에 실행하며 상태 확인 할당량 소진 속도를 살펴 작업 도중 한도에 도달하지 않도록 관리 토큰과 비용을 가장 많이 사용한 모델 및 세션 확인 자리를 비운 동안 휴대폰이나 시계에서 에이전트 작업 승인
agent-hud-open는 어떻게 설치하나요?
Mac에 Homebrew로 설치: brew install --cask jazzenchen/tap/agent-hud 또는 Mac, Windows, Linux에 Node.js로 설치: npx @agenthud/install
agent-hud-open은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jazzenchen/agent-hud-open

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트