프로젝트 소개

Cloudx는 Codex CLI를 위한 로컬 프라이트 워크벤치로, 사용자 자신의 Linux 빌드 머신에서 실행되며 데스크톱이나 휴대폰 브라우저에서 조종됩니다. 코드, 자격 증명, 셸 도구 및 Codex 로그인은 호스트에 유지되며, 프로젝트는 프라이빗 tailnet을 권장하고 공개 인터넷 노출은 지원되지 않는다고 명시합니다. README는 Cloudx가 터미널을 생성하고 셸 및 Codex로 텍스트를 보내며, 구성된 루트 아래의 파일을 읽고 편집하며, 토큰 포함 URL이 있는 로컬 대시보드를 임베드할 수 있다고 경고합니다. 또한 직접 LAN 클라이언트의 인증은 수행하지 않습니다. 신뢰할 수 있는 방화벽 보호 LAN을 위해 명시적인 0.0.0.0 바인드가 존재합니다. UI는 데스크톱과 휴대폰 모두에 반응형입니다. 워크스페이스는 독립적인 창 레이아웃, 기본 작업 디렉토리, 빠른 이름 검색 및 AI 기반 컨텍스트 검색을 갖춘 서버 백엔드 윈도우입니다. 페인은 tmux와 유사하게 동작하며 이동 가능한 플러그인 탭을 제공합니다. 레이아웃 템플릿을 사용하여 다른 프로젝트 경로에서 창/탭 배열을 저장하고 다시 열 수 있습니다. README에 설명된 플러그인과 도구로는: Codex 및 일반 셸 터미널 탭(클립보드 PNG/JPEG/WebP/GIF 붙여넣기는 .cloudx/pasted-images에 저장되고 @ 파일 참조로 삽입됨), 음성 노출 읽기/쓰기 작업, 활성 파일 검색, 선택적 Git 설정, 변경 파일 배지 및 렌더링된 파일별 diff를 갖춘 파일 브라우저, 빈 리포지토리 생성 또는 클론 및 프로젝트 워크트리 관리를 위한 워크트리 관리자, 대시보드 호스팅용 로컬 웹 플러그인, Epic별 그룹화된 할당된 이슈 대시보드를 위한 Jira Cloud 플러그인(주석, 전환, 링크, 브라우저 링크, 폴링 또는 수동 자동화 트리거 포함), 파일을 경로, URL, YouTube 재생 목록, 복사된 텍스트, 미디어转录물로 삽입하여 검색, 소스 검사, 무효화, 대기열 가져오기 및 자동 Codex 규칙/스킬 주입을 수행하는 문서 아카이브 플러그인이 포함됩니다. Automation 탭은 트리거 이벤트, 플러그인 후크, 프리미티브 및 컨버터를 보존된 그래프로 구성하며, Python 및 Bash 실행 프리미티브와 cloudx.call_hook API를 제공합니다. 음성 제어는 브라우저 오디오, 로컬 Faster Whisper 서비스 및 구성된 planner 모델을 사용합니다. Cloudx는 마이크 접근을 위해 로컬 자체 서명 인증서로 포트 3001에서 HTTPS를 제공합니다. Codex 터미널 기본값은 관리됩니다: Codex는 명시적 --yolo 모드로 실행되며, 로컬 메모리와 Codex 앱은 비활성화되고, 에이전트 플러그인은 비활성화되며, 탭에서 생성된 Codex 홈에서만 Cloudx가 선택한 시스템 및 번들 스킬만 활성화됩니다. 페이지를 다시 로드하면 실행 중인 터미널 탭이 재생 버퍼와 다시 연결되고, Cloudx 서비스를 재시작하면 해당 프로세스가 종료됩니다. 재개 모드(피커, 마지막, ID)는 공유 세션을 사용합니다. 저장소 구성 요소는 다음과 같습니다: apps/server(Fastify 서버, 플러그인 호스트, 세션, 터미널, 로컬 웹 프록시, ASR 브리지, 음성 컨트롤러), apps/web(React/Vite UI), packages/plugin-api, packages/shared, services/asr(Faster Whisper), services/documentation-indexer(FastAPI 인덱서), 자격 증명 없는 네트워크 미승인 확인 컨테이너, 보안 모델, 설정, 동기부여, AI 관련 기여 프로세스를 다루는 여러 문서. 플러그인은 .cloudx-plugin/plugin.json을 포함한 GitHub 저장소에서 메타데이터로 설치할 수도 있으며, 해당 경로는 제삼자 플러그인 코드를 실행하지 않습니다. 설치는 안내되는 install.sh를 통해 Ubuntu 22.04 이상을 대상으로 하며, 각 단계 미리보기, 시스템 패키지 및 필요 시 Node.js 22 설치, Git 2.36+ 확인, 고정된 Codex CLI 릴리스 설치, ASR 및 문서 인덱서 환경 준비, 구성 작성, nvidia-smi를 통한 NVIDIA GPU 감지, 사용자 수준 서비스 설치를 수행합니다. --dry-run, --yes, --verbose, --update, --uninstall 옵션이 문서화되어 있으며, 수동 npm ci/build/dev 시작 및 정확한 origin 허용이 필요한 Vite 개발 워크플로우도 있습니다. 구성은 환경 변수로 구동되며, 바인드 호스트 및 포트, 신뢰 원본, 로그 레벨, 허용된 루트, 어시스턴트 바이너리, ASR URL/디바이스/컴퓨트 타입 및 오디오 업로드 제한, 문서 인덱서 URL/호스트/포트/시간 제한/업로드 제한 및 데이터 디렉토리, 음성 planner 모델을 포함합니다. README는 이 프로젝트가 에이전트 보조 워크플로우로 구축되었으며 유용하지만 견고한 서비스가 아니며 MIT 라이선스로 배포된다고 밝히고 있습니다.