marmottajr/habblaud

어떤 프로젝트인가요?

핵심 기능

• 01각 프로젝트를 방으로, Claude Code 또는 Codex 에이전트를 애니메이션 캐릭터로 표시합니다.
• 02작업 중, 입력 대기, 셸 명령 대기 등 실시간 상태를 보여줍니다.
• 03계정별 5시간 및 주간 사용량을 표시합니다.
• 04선택 사항인 모드를 설치하면 사무실 화면에서 권한 요청을 승인하고 에이전트 질문에 답할 수 있습니다.
• 05타임라인으로 하루 활동을 다시 볼 수 있으며, 런타임 의존성 없이 Node 또는 Docker에서 실행됩니다.

활용 사례

• 여러 프로젝트에서 동시에 실행 중인 Claude Code 세션을 한눈에 파악하기.
• 터미널을 전환하지 않고 권한 요청에서 멈춘 에이전트 찾기.
• 에이전트가 시작한 장시간 셸 명령 모니터링하기.
• AI 코딩 세션을 여러 개 실행하면서 계정 사용량 한도 확인하기.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/marmottajr/habblaud.git
2. 2

   폴더로 이동해 빌드 도구를 설치합니다

   cd habblaud && npm install
3. 3

   Docker 없이 Habblaud를 빌드하고 시작합니다

   npm run build && npm start
4. 4

   브라우저에서 localhost:4747을 열어 오피스에 접속합니다

사용 전 알아둘 점

• !macOS에서 테스트되었습니다. Linux는 언급되어 있지만 Windows는 언급되어 있지 않습니다.
• !권장 mod를 사용하려면 Claude Code 2.1.287 이상과 Node.js 22.12 이상이 필요합니다.
• !실시간 사용량 표시 및 오피스에서 답변하기 같은 일부 기능을 사용하려면 각 계정에 hooks 또는 mod를 설치해야 합니다.

토픽

자주 묻는 질문

habblaud은(는) 무엇인가요?

Claude Code나 Codex 프로젝트를 방으로, 각 에이전트를 실시간 활동을 보여주는 픽셀 아트 캐릭터로 표현하는 가상 사무실입니다. Habblaud는 Claude Code와 Codex 세션을 픽셀 아트 사무실로 바꿔 보여줍니다. 세션이 열려 있는 프로젝트마다 방이 하나씩 생기고, 각 에이전트는 현재 작업에 따라 애니메이션이 달라지는 캐릭터로 표시됩니다. 작업 중에는 타이핑하고, 권한이나 답변이 필요하면 손을 들며, 셸 명령이 실행되는 동안에는 책상에서 기다립니다. 하위 에이전트는 동료로 나타나 작업을 시작한 에이전트에게 결과를 전달합니다.

habblaud은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

habblaud은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

habblaud은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. habblaud의 마지막 커밋은 2026년 10월 16일입니다.

habblaud은(는) 어디에 사용할 수 있나요?

여러 프로젝트에서 동시에 실행 중인 Claude Code 세션을 한눈에 파악하기. 터미널을 전환하지 않고 권한 요청에서 멈춘 에이전트 찾기. 에이전트가 시작한 장시간 셸 명령 모니터링하기. AI 코딩 세션을 여러 개 실행하면서 계정 사용량 한도 확인하기.

habblaud는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/marmottajr/habblaud.git 폴더로 이동해 빌드 도구를 설치합니다: cd habblaud && npm install Docker 없이 Habblaud를 빌드하고 시작합니다: npm run build && npm start 브라우저에서 localhost:4747을 열어 오피스에 접속합니다

habblaud은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/marmottajr/habblaud