rullerzhou-afk/clawd-on-desk

A pixel desktop pet that watches Claude Code, Codex, Cursor & other AI coding agents — so you don't have to.

Clawd on Desk 는 무엇인가요?

Clawd on Desk 는 당신의 AI 코딩 어시스턴트(Claude Code, Copilot, Gemini, Cursor 등)의 활동을 감시하고 실시간으로 반응하는 작고 귀여운 데스크톱 펫 앱(픽셀 아트의 게, 고양이, 구름 모양의 생물)입니다. 어시스턴트가 생각 중이거나 타이핑 중이거나 도구를 실행 중이거나 하위 에이전트를 생성하거나 권한을 요청할 때, Clawd 는 그에 따라 애니메이션됩니다. 당신이 idle 상태일 땐 잠들고, 하위 에이전트가 실행되면 춤추며, 권한 요청 시 클릭 가능한 권한 버블을 띄우고, 작업이 완료되면 축하 애니메이션을 보여줍니다.

Windows 11, macOS, Linux 에서 작동하며, 사전 빌드된 설치 파일(x64/ARM64)로 설치하거나 Node.js 로 소스에서 빌드할 수 있습니다.

핵심 기능

카테고리	기능
다중 에이전트 지원	수십 개의 AI 코딩 에이전트(Claude Code, Codex CLI, Copilot CLI, Gemini, Cursor, Qwen, CodeWhale, Pi, OpenClaw 등)에 대한 훅 지원. 사용자 정의 HTTP 기반 에이전트도 등록 가능.
실시간 애니메이션	12가지 애니메이션 상태(idle, thinking, typing, building, sub-agent groove, juggling, error, happy, notification, sweeping, carrying, sleeping). 마우스 커서를 따라 눈이 움직이며, 더블클릭으로 펫을 툭툭 칠 수 있고, 드래그 앤 드롭으로 위치를 이동할 수 있습니다.
권한 버블	에이전트가 권한을 요청하면, 허용 / 거부 / 항상 허용 버튼이 있는 부유형 카드를 표시합니다. 핫키(`Ctrl+Shift+Y/N`)도 지원. 모드로 자동 승인, 매번 확인, 또는 도구 유형 요청에만 확인 가능.
원격 승인	권한 요청을 Telegram 또는 Feishu/Lark로 전달할 수 있습니다. Slack은 작업 완료, 오류, 권한 프롬프트에 대한 읽기 전용 알림을 받을 수 있습니다.
세션 대시보드 및 HUD	오른쪽 클릭 → 대시보드 열기 를 통해 실시간 세션, 할당량을 확인하고, 해당 터미널 창으로 바로 이동할 수 있습니다. 펫 근처에 컴팩트한 HUD를 항상 표시할 수 있습니다.
모바일 동반자(PWA)	토큰 기반의 LAN 전용 웹 앱으로 스마트폰에서 데스크톱 상태를 읽기 전용으로 미러링합니다.
시스템 편의성	클릭 투명 영역, 위치 기억, 싱글 인스턴스 잠금, Claude Code 훅을 통한 자동 시작, Do-Not-Disturb 모드, 사운드 효과, 시스템 트레이 메뉴, GitHub 릴리스를 통한 자동 업데이트, UI 로컬라이제이션(영어, 중국어, 한국어, 일본어, 포르투갈어, 스페인어).

시작하기

다운로드: Releases 페이지에서 OS용 설치 파일을 다운로드하거나, 리포지토리 클론 후 npm install && npm run build 실행.
실행: 앱을 실행하면 데스크톱에 피크셀 펫이 나타납니다.
설정 → 에이전트 에서 사용 중인 AI 코딩 도구의 설치 버튼을 클릭(예: npm run install:gemini-hooks). 이 명령어는 적절한 훅 파일(~/.gemini/settings.json, ~/.copilot/hooks/hooks.json 등)을 생성하여 에이전트가 Clawd 에 생명 주기 이벤트를 보고하도록 합니다.
관찰: 코드를 작성하면서 펫이 애니메이션되는 모습을 확인하세요. 권한 요청이 나타나면 버블을 클릭하거나 핫키로 응답하세요.
(옵션) 원격 알림 을 설정 → 원격 에서 활성화하여 Telegram/Feishu로 권한 요청을 전달하거나 Slack 알림을 받으세요.
(옵션) 모바일 / PWA 를 켜서 스마트폰에서 실시간 상태를 확인하세요.

누가 이걸 좋아할까?

AI 기반 코딩 어시스턴트를 장시간 사용하며 백그라운드 작업이 진행 중인지 시각적으로 확인하고 싶은 개발자.
터미널로 전환하지 않고도 빠르고 쉽게 권한을 처리하고 싶은 팀.
AI 에이전트의 활동을 반영하는 재미있는 데스크톱 동반자를 즐기고 싶은 사람.

더 알아보기

설치 가이드 – docs/guides/setup-guide.md
사용자 정의 에이전트 통합 – docs/guides/custom-agent-http.md
Slack 알림 문서 – docs/guides/slack-notifications.md
모바일 동반자 리포지토리 – https://github.com/Bynlk/clawd-on-mobile

빠른 참조

기능	세부 정보
지원되는 에이전트	Claude Code, Codex CLI, Copilot CLI, Gemini CLI, Antigravity, Cursor, CodeBuddy, WorkBuddy, Kiro, Kimi-CLI, Qwen, ZCode, CodeWhale, Reasonix, opencode, MiMo, Pi, OpenClaw, Hermes, Qoder, QoderWork, QwenWork, DeepSeek Harness
플랫폼	Windows 11 (x64/ARM64), macOS, Ubuntu/Linux
언어	UI: 영어 + 6개 번역; 테마는 사용자 정의 가능(픽셀 아트 아틀라스)
라이선스	(README에 기재되지 않음 – 리포지토리 확인)
최신 버전	GitHub 릴리스 배지로 표시

Clawd on Desk 는 AI 코딩 에이전트의 보이지 않는 작업을 친근하고 상호작용 가능한 데스크톱 경험으로 바꾸어, 시각 피드백, 쉬운 권한 처리, 선택적 원격 알림을 제공하면서도 귀여운 외모를 자랑합니다.