GitHub - slopus/happy: Mobile and Web client for Codex and Claude Code, with realtime voice, encryption and fully featured

이 문서는 AI 코딩 에이전트인 Claude Code와 Codex를 위한 모바일 및 웹 클라이언트인 slopus/happy 프로젝트에 대한 설명입니다. 이 프로젝트의 주요 목표는 사용자가 데스크톱에서 벗어나 있는 동안에도 AI 코딩 작업의 진행 상황을 모니터링하고 제어할 수 있도록 하는 것입니다.

핵심 기능은 다음과 같습니다:

• 다중 플랫폼 지원: iOS, Android 앱 및 웹 앱을 통해 다양한 기기에서 접근할 수 있습니다.
• 종단간 암호화 (End-to-end encryption): 사용자 코드가 암호화되지 않은 상태로 기기를 벗어나지 않도록 보장하여 보안을 강화합니다.
• 푸시 알림 (Push notifications): Claude Code 또는 Codex가 사용자 승인을 필요로 하거나 오류가 발생할 때 모바일 장치로 알림을 보냅니다.
• 즉각적인 장치 전환 (Instant device switching): 모바일 장치와 데스크톱 간에 제어를 원활하게 전환할 수 있습니다.
• 오픈 소스 (Open source): 코드 공개를 통해 사용자가 직접 감사할 수 있으며, 텔레메트리(telemetry)나 추적 기능이 포함되어 있지 않습니다.

이 프로젝트의 핵심 방법론은 happy-coder CLI 도구를 통해 AI 코딩 에이전트와 상호 작용하는 것입니다. 사용자는 자신의 컴퓨터에 happy-coder CLI를 설치한 후, 기존의 claude 또는 codex 대신 happy 또는 happy codex 명령어를 사용하여 AI를 시작합니다. 여기서 happy CLI는 실제 AI 에이전트를 래핑(wrapping)하는 역할을 합니다.

사용자가 모바일 장치에서 코딩 세션을 제어하고 싶을 때, 이 래퍼는 세션을 "원격 모드(remote mode)"로 전환합니다. 이 원격 모드에서는 모바일 클라이언트 (happy-coder 앱)를 통해 AI의 진행 상황을 실시간으로 확인하고 필요한 상호 작용을 수행할 수 있습니다. 데스크톱으로 다시 제어를 전환하려면 단순히 키보드의 아무 키나 누르면 됩니다.

이러한 원격 접근 및 제어는 happy-server라는 백엔드 서버 컴포넌트를 통해 이루어지며, 이 서버는 암호화된 동기화(encrypted sync)를 담당하여 기기 간의 데이터 전송을 안전하게 관리합니다. 프로젝트는 happy-cli (명령줄 인터페이스), happy-server (암호화된 동기화를 위한 백엔드 서버), 그리고 happy-coder (모바일 클라이언트)의 세 가지 주요 컴포넌트로 구성됩니다. MIT License 하에 배포됩니다.