ramarivera/coding-buddy

해결하는 문제

Coding Buddy는 Claude Code, Pi, Oh My Pi와 같은 AI 코딩 보조 도구를 위한 지속 가능한 애니메이션 ASCII 동반자를 제공합니다. 이 프로젝트는 Claude Code에서 제거된 '버디' 기능을 복원하며, 바이너리 패치가 아닌 Model Context Protocol (MCP)를 사용하여 소프트웨어 업데이트 후에도 동반자가 유지되도록 보장합니다.

작동 방식

이 프로젝트는 여러 안정적인 확장 포인트를 통해 AI 핸드헬스와 통합됩니다:

• MCP 서버: AI가 턴의 끝에서 반응을 트리거하도록 지시하는 도구와 시스템 프롬프트를 제공합니다.
• 스킬: /buddy와 같은 슬래시 명령어를 구현하여 통계를 확인하고 동반자와 상호작용할 수 있습니다.
• 상태줄: 터미널의 상태줄에 애니메이션 ASCII 아트와 대화창을 렌더링합니다.
• 훅: 오류나 테스트 실패와 같은 이벤트를 감지하기 위해 쉘 래퍼를 사용하여 특정 버디 반응을 트리거합니다.

동반자의 정체성은 사용자의 계정 UUID를 기반으로 결정론적 알고리즘(wyhash + mulberry32)을 사용해 생성되며, 동일한 사용자에게 항상 동일한 버디가 할당됩니다.

대상 사용자

Claude Code, Pi, 또는 Oh My Pi를 사용하며 코딩 세션에 게임화된 시각적 동반자를 원하는 개발자들입니다.

주요 특징

• 업데이트에 강함: MCP 기반으로 구현되어 호스트 AI 도구가 업데이트되어도 깨지지 않습니다.
• 다양한 생물군: 공통에서 전설까지의 레어리티를 가진 19종의 다양한 종류와 고유한 스탯(디버깅, 인내심, 혼란, 지혜, 풍자)을 갖추고 있습니다.
• 사전 정의된 백업 메시지: AI 모델이 반응하지 못하더라도 대화창이 항상 소리를 내도록, 백업 라인 풀을 사용합니다.
• 다중 핸드헬스 동기화: 환경 변수를 통해 다양한 AI 코딩 도구 간에 단일 버디 정체성을 공유할 수 있는 옵션 지원입니다.
• TUI 선택기: 특정 버디 종류와 레어리티를 검색하고 저장할 수 있는 인터랙티브 터미널 사용자 인터페이스입니다.