gronxb/codex-relay

Use Codex from your phone while the real work stays on your computer.

해결하는 문제

Codex Relay는 컴퓨터의 Codex CLI와 모바일 기기에서 상호작용할 수 있는 방법을 제공합니다. 사용자는 워크스테이션에 물리적으로 있을 필요 없이 AI 기반 코딩 세션을 모니터링하고 제어할 수 있으며, 실제 코드 실행과 세션 상태는 로컬 머신에 안전하게 유지됩니다.

작동 방식

시스템은 로컬 릴레이 서버(Node.js로 실행)와 페어링된 모바일 앱으로 구성됩니다. 릴레이 서버는 모바일 앱을 컴퓨터의 Codex CLI 세션에 연결하는 중개자 역할을 합니다. 페어링은 QR 코드와 승인 프로세스를 통해 처리됩니다. 릴레이는 독립 모드 또는 공유 모드로 실행할 수 있으며, 공유 모드에서는 터미널 TUI가 모바일 앱과 동일한 세션을 공유할 수 있습니다.

대상 사용자

Codex CLI를 사용하는 개발자로, 코드 변경 검토, 프롬프트 전송, AI의 입력 또는 승인 요청에 대한 응답을 휴대폰에서 수행할 수 있는 유연성을 원하는 분들.

주요 기능

  • 로컬 우선 아키텍처: 코드, 셸, Git 상태는 컴퓨터에 유지되며, 휴대폰은 로컬 릴레이와만 통신합니다.
  • 원격 제어: 모바일 기기에서 프롬프트 전송, 스레드 계속, 승인 제공이 가능합니다.
  • 워크스페이스 미리보기: Git 변경 사항, 로컬 웹 출력, 터미널 화면을 모바일에서 직접 확인할 수 있습니다.
  • 푸시 알림: 턴 완료 또는 AI가 사용자 작업을 요구할 때 알림을 받습니다.
  • Tailscale 통합: 다른 네트워크에서 릴레이 및 웹 미리보기에 접근하기 위한 안전한 네트워킹을 간소화합니다.

관련

  • Dispatch
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트