gronxb/codex-relay

해결하는 문제

Codex Relay는 사용자가 모바일 기기에서 Codex CLI 세션을 모니터링하고 제어할 수 있도록 합니다. AI 기반 코딩 작업의 진행 상황을 확인하거나, 입력을 제공하거나, 작업을 승인하기 위해 반드시 컴퓨터 앞에 있어야 하는 문제를 해결합니다.

작동 방식

사용자의 워크스페이스에서 로컬 리레이 서버를 실행하고, 로컬 네트워크(또는 Tailscale 같은 도구를 통해) 모바일 앱과 연결합니다. 리레이 서버는 다리 역할을 하여 Codex의 출력을 스마트폰으로 스트리밍하고, 프롬프트나 승인을 컴퓨터로 전송합니다. 보안과 프라이버시를 유지하기 위해, 코드와 세션 데이터는 컴퓨터에 그대로 유지되며, 스마트폰은 로컬 리레이 서버와만 통신하는 로컬 우선 시스템으로 설계되었습니다.

대상 사용자

데스크에서 벗어난 상태에서도 AI 코딩 세션을 제어하고, git 변경 사항을 검토하거나, 입력 요청에 응답하고 싶은 Codex CLI 사용자.

주요 기능

• 원격 제어: 스마트폰에서 프롬프트를 보내고 스레드를 이어가며 Codex의 입력 요청에 응답할 수 있습니다.
• 로컬 우선 프라이버시: 코드, 쉘, git 상태는 모두 컴퓨터에 유지됩니다. 스마트폰은 로컬 리레이 서버와만 통신합니다.
• 워크스페이스 미리보기: git 변경 사항, 로컬 웹 출력, 파일, 터미널 표면을 모바일에서 확인할 수 있습니다.
• 푸시 알림: 작업이 완료되었거나, 조치가 필요할 때 알림을 받을 수 있습니다.
• 공유 세션: 공유된 앱-서버를 사용해 모바일 세션을 터미널 TUI와 동기화할 수 있습니다.