프로젝트 소개

WebCodex는 클라우드 기반 AI 에이전트(예: ChatGPT 및 Claude)와 로컬 개발 환경을 연결하는 오픈 소스 도구입니다. 개발자가 호스팅된 작업 공간에 코드를 업로드하도록 요구하는 대신, WebCodex는 AI 에이전트가 개발자 자신의 머신에서 저장소와 직접 상호 작용하고, 명령을 실행하고, Git을 사용하고, 테스트를 실행하고, 장기 실행 작업을 수행할 수 있게 합니다. 이 도구는 Server/Runner 아키텍처를 통해 작동합니다. Server는 AI 클라이언트가 MCP(Model Context Protocol) 또는 HTTPS를 통해 연결되는 중개자 역할을 하며, Runner는 로컬 머신에서 작업을 실행합니다. 이 설계는 저장소와 모든 개발 도구를 원래 머신에 유지하여 기존 개발 환경을 보존합니다. WebCodex는 두 가지 주요 사용 모드를 지원합니다. 일상적인 개발을 위해 사용자는 일반 Server와 Runner를 설정하여 프로젝트 탐색, 편집, Git 작업, 명령 실행, 테스트, 코드 탐색을 포함한 전체 기능으로 여러 프로젝트에 지속적으로 액세스할 수 있습니다. 빠른 평가를 위해 원커맨드 `share` 모드는 임시 단일 프로젝트 인스턴스를 시작하여 ChatGPT용 연결 값을 출력합니다. 이 도구는 여러 플랫폼을 지원합니다: Linux(x64/arm64), macOS(x64/arm64), Windows(x64 및 arm64). Windows 및 macOS 사용자는 가장 간단한 설정을 위해 공식 OpenAI Secure Tunnel과 함께 WebCodex Desktop 애플리케이션을 사용하는 것이 좋습니다. 모든 플랫폼에서 CLI 기반 설정을 사용할 수 있으며, 자체 호스팅 및 고급 구성 옵션도 제공됩니다. 주요 기능은 다음과 같습니다: 코드 읽기, 검색, 검사, 안전하게 보호된 변경 수행; 명령, 테스트, 포맷터, 컴파일러 및 프로젝트별 도구 실행; Git을 사용하여 상태 및 diff 검사; 관찰 가능한 작업으로 장기 실행 작업 처리; Runtime Console, Workflow Session 증거, Git/diff 검토를 통한 인간 검토 지원. WebCodex는 Rust로 빌드되었으며(Cargo를 사용하여 빌드) Apache License 2.0에 따라 라이선스가 부여됩니다. 이 프로젝트에는 데스크톱 설치, 전체 설정, 빠른 평가판, MCP 통합, 배포, 문제 해결, CLI 참조, AI 지원 설정 및 보안 지침을 다루는 포괄적인 문서가 포함되어 있습니다.