ntd4996/agentpet

AgentPet – AI 코드 에이전트를 감시하는 데스크톱 동반자

무엇인가요 – AgentPet은 무료로 오픈소스인 데스크톱 애플리케이션(맥OS, 윈도우, 리눅스)으로, 메뉴바에 자리 잡고 실행 중인 AI 코드 에이전트(Claude Code, Codex, Gemini, Cursor 등)의 실시간 상태를 표시합니다. 동시에 화면에 떠 있는 작은 애니메이션 '펫'이 토큰 소비와 세션 완료에 따라 경험치를 얻고 진화합니다. 핵심 기능은 완전히 오프라인에서 작동하며, GitHub로 로그인하면 옵션으로 웹 동기화, 공개 랭킹, 다중 기기 복원 기능을 사용할 수 있습니다.

주요 기능

• 다중 에이전트 모니터 – 색상으로 구분된 상태 점, 프로젝트 이름, 에이전트의 현재 작업, 실시간 타이머를 표시하는 메뉴바 목록. 어떤 에이전트라도 입력이 필요하면 트레이 아이콘이 주황색으로 변합니다.
• 데스크톱 펫(타마고치 스타일) – 에이전트가 소비하는 토큰과 완료한 세션을 '먹는' 펫이 경험치(XP)를 얻고 5단계로 레벨업하며 14개의 업적을 해금합니다. 펫을 오른쪽 클릭하면 레벨, 배고픔, 7일간의 사용량 차트, 실시간 Claude/Codex 구독 한도를 보여주는 HUD가 표시됩니다.
• 프로젝트별 펫 및 사용량 대시보드 – 폴더에 펫을 할당할 수 있으며, 대시보드는 프로젝트별 및 에이전트별 토큰 사용량을 분석(일별/월별 차트). 최근 90일간의 기록은 로컬에 저장됩니다.
• 옵션 웹 프로필 – GitHub로 로그인하면 펫을 공개하고 커뮤니티 랭킹에 이름을 올리며, 여러 기기 간에 진도를 동기화할 수 있습니다. 데이터는 명시적으로 허용하지 않는 한 컴퓨터 외부로 나가지 않습니다.
• 확장 가능한 에이전트 지원 – 11개의 에이전트가 미리 설정되어 있으며, 어떤 명령줄 도구라도 agentpet run -- <command>로 감싸 사용할 수 있습니다.
• 사용자 정의 펫 팩 – 펫은 오픈된 Codex pet-pack 형식(pet.json + 스프라이트시트)을 따릅니다. 사용자는 웹 갤러리를 통해 팩을 탐색, 채택, 또는 직접 제출할 수 있습니다.

지원 플랫폼

• macOS 13+ – 네이티브 Swift/SwiftUI 앱, 노트리제이션 완료, Sparkle를 통한 자동 업데이트.
• Windows 10/11 (64비트) – Tauri(Rust) 빌드, 자동 업데이트, 사용자 기반 설치.
• Linux (64비트) – 동일한 Tauri 바이너리를 AppImage, .deb, .rpm 형식으로 배포. AppImage는 앱 내 자동 업데이트 지원.

설치 방법

• macOS: brew install --cask ntd4996/tap/agentpet 또는 GitHub 릴리스 페이지에서 서명된 .dmg를 다운로드.
• Windows: 웹사이트 또는 릴리스 페이지에서 설치 프로그램 또는 포터블 zip을 다운로드.
• Linux: AppImage, DEB, RPM을 다운로드하거나, curl … | sh 한 줄 명령어로 최신 AppImage를 가져옵니다.
• 소스에서 빌드(맥OS)에는 Xcode 16 / Swift 6 필요. 윈도우 소스는 windows/ 폴더에 있으며(Tauri + Rust).

작동 방식

1. 설정 → 일반 에서 각 AI 코드 에이전트의 훅을 설치합니다.
2. 일반적으로 에이전트를 실행합니다. AgentPet은 유닉스 소켓 데몬을 통해 이벤트를 수신합니다.
3. 펫이 화면에서 반응하고, 메뉴바 아이콘이 업데이트되며, XP/레벨은 로컬에 기록됩니다.
4. (옵션) GitHub로 로그인하여 펫을 동기화하고 웹 프로필을 확인하며 랭킹에서 경쟁합니다.

커뮤니티 – 베트남어, 간체자 중국어, 번체자 중국어, 일본어 번역 지원. 커뮤니티 유지 관리 포트(예: Rust + GTK4 리눅스 버전). 펫은 사용자들이 기여하며 개별 라이선스를 따릅니다. 앱 자체는 MIT 라이선스입니다.

라이선스 – 애플리케이션 코드는 MIT 라이선스. 펫 자산은 리포지토리에 포함되지 않으며 각 제작자의 라이선스에 따라 유지됩니다.