ethanplusai/jarvis

해결하는 문제

JARVIS는 Claude Code용 음성 제어 인터페이스로, 터미널 기반의 AI 코딩 보조 도구를 손을 떼고 대화형 에이전트로 전환하도록 설계되었습니다. 복잡한 프로젝트 설계 및 실행 중에 CLI 도구와 수동으로 상호작용하는 번거로움과 동시에 여러 AI 코딩 세션을 관리하는 문제를 해결합니다.

작동 방식

JARVIS는 Claude Code CLI를 래핑하는 역할을 합니다. 지속적인 claude -p 프로세스를 자신의 '뇌'로 사용하며, WebSockets와 FastAPI를 통해 통신합니다. 음성 입력은 Chrome Web Speech API를, 음성 출력은 Fish Audio를 통합합니다.

소프트웨어 빌드를 제어하기 위해 JARVIS는 구조화된 파이프라인을 따릅니다: 사용자와 음성으로 설계를 브레인스토밍하고, 공식적인 설계 문서를 디스크에 저장한 후, 테스트 주도 개발을 사용하여 계획을 실행하기 위해 별도의 Claude Code 세션을 생성합니다. 또한 AppleScript를 통해 머신 상의 모든 활성 Claude Code 세션을 모니터링하며, 세션이 허가나 입력을 기다리는 경우 음성으로 사용자에게 알립니다.

대상 사용자

macOS와 Claude Code를 사용하며, AI 보조 코딩 워크플로우와 프로젝트 빌드를 음성으로 제어하는 에이전트 경험을 원하는 개발자들입니다.

주요 기능

• 음성 기반 설계: 코드 실행 전에 음성으로 프로젝트 사양을 브레인스토밍하고, Markdown 파일로 저장합니다.
• 세션 모니터링: 머신 상의 모든 Claude Code 세션을 감시하며, 허가나 입력을 기다리는 세션이 있을 경우 사용자에게 음성으로 알립니다.
• 구독 기반: 별도의 API 키가 필요 없이 사용자의 기존 Claude 구독으로 작동하며, 실수로 API 요금이 발생하는 것을 방지하기 위해 환경 변수 정리 기능이 내장되어 있습니다.
• 에이전트형 빌드 파이프라인: 계획-검토-실행 사이클을 통해 빌드를 제어하며, 설계 사양 내 체크박스를 통해 진행 상황을 추적합니다.
• MCP 통합: 확장 기능을 제공하는 Model Context Protocol (MCP) 서버를 지원합니다.
• 장기 기억: 세션 간에 사실을 기억하기 위해 일반 Markdown 파일 폴더를 유지합니다.