CodeBuddy은(는) 무엇을 하나요?
Claude Desktop의 승인 및 세션 모니터링을 StickS3 하드웨어 동반자에게 오프로드합니다.
개요
CodeBuddy는 Claude Desktop과 StickS3 하드웨어 장치 간의 브리지 역할을 하여 AI 비서와 물리적으로 상호작용할 수 있도록 합니다. 승인, 세션 상태 및 활동 알림을 전용 하드웨어 인터페이스로 오프로드하여 방해를 최소화하면서 중요한 작업을 제어할 수 있습니다.
작동 방식
- Claude Desktop과 WebSocket을 통해 연결을 설정합니다.
- 승인 프롬프트, 세션 업데이트 및 상태 알림을 StickS3 하드웨어로 전달합니다.
- StickS3의 물리적 버튼으로 작업 승인, 거부 또는 일시 중지할 수 있습니다.
- LED 표시등은 현재 세션 상태(대기 중, 활성, 오류 등)를 시각적으로 알려줍니다.
주요 기능
- 승인 오프로드: 승인 프롬프트를 데스크톱이 아닌 StickS3로 전송하여 방해 최소화
- 세션 모니터링: Claude Desktop 세션의 상태(활성, 대기 중, 오류)를 실시간으로 확인
- 물리적 제어: 하드웨어 버튼으로 작업 승인/거부
- 시각적 상태 표시: LED를 통해 세션 상태를 한눈에 파악
요구 사항
- Claude Desktop (최신 버전)
- StickS3 하드웨어 장치
- USB-C 연결 (StickS3 연결용)
- Python 3.8+
설치
git clone https://github.com/shier3135/CodeBuddy.git
cd CodeBuddy
pip install -r requirements.txt
설정
- StickS3 장치를 USB-C로 연결합니다.
- 환경 변수를 설정합니다:
exPORT CLAUDE_WS_URL="ws://localhost:PORT/claude"
exPORT STICKS3_PORT="/dev/ttyUSB0" # Linux/macOS
exPORT STICKS3_PORT="COM3" # Windows
- 서비스를 시작합니다:
python main.py
사용법
시스템이 실행되면:
- 승인이 필요한 작업이 발생하면 StickS3가 진동/LED 깜빡임으로 알림
- 버튼 A를 눌러 승인, 버튼 B를 눌러 거부
- LED 색상: 녹색(활성 세션), 파란색(대기 중), 빨간색(오류)
문제 해결
StickS3가 감지되지 않는 경우:
- USB 연결 확인
- 올바른 포트 경로 확인 (
ls /dev/tty*또는 장치 관리자 사용) - 드라이버가 설치되어 있는지 확인
WebSocket 연결 오류:
- Claude Desktop이 실행 중인지 확인
- WebSocket URL이 올바르게 설정되었는지 확인
- 방화벽이 연결을 차단하지 않는지 확인
기여
기여는 언제나 환영합니다! Pull Request를 자유롭게 제출해주세요.
라이선스
MIT