rebel0789/codexpro

CodexPro – ChatGPT에 코드 저장소에 대한 안전한 로컬 액세스 권한 제공

개요 – CodexPro는 OpenAI의 ChatGPT를 위한 사용자 지정 MCP (Model-Client-Plugin) 역할을 하는 소형 Node-JS 서버입니다. 머신에서 실행하고 ChatGPT 내의 플러그인으로 등록하면, 모델은 명시적으로 허용한 저장소의 파일에 대해 읽기, 검색, 편집 및 검사 실행을 수행하는 도구 세트를 호출할 수 있습니다. 모든 분석은 컴퓨터 내에 유지되며, 타사 서비스로 업로드되지 않습니다.

중요성 – 최근의 "코드 어시스턴트" 열풍(GitHub Copilot, ChatGPT Code Interpreter 등)은 종종 클라우드에서 실행되어 소스 코드를 원격 서버로 전송합니다. CodexPro는 이 모델을 뒤집습니다. LLM은 OpenAI의 클라우드에 머물지만, 무거운 코드 인텔리전스(언어 감지, 심볼 인덱싱, 영향 분석)는 로컬에서 실행되므로 개인정보 보호, 보안 및 재현성을 더 엄격하게 제어할 수 있습니다.

빠른 시작 (README 참조)

전제 조건
- Node 20+ 설치됨
- 사용자 지정 MCP 플러그인을 추가할 수 있는 ChatGPT 계정
- 머신을 가리키는 HTTPS 엔드포인트 (예: Cloudflare tunnel, ngrok 또는 Tailscale Funnel)
CLI 설치
```
npm install -g codexpro
```
저장소 설정
```
cd /path/to/your/project
codexpro setup
```
이 작업은 로컬 구성을 생성하고 ChatGPT에 제공할 HTTPS URL을 출력합니다.
ChatGPT에 플러그인 추가
- Settings → Security & login에서 Developer mode를 켭니다.
- Settings → Plugins → Search plugins 옆의 **+**를 클릭합니다.
- CodexPro라는 이름의 플러그인을 만들고 3단계의 URL을 붙여넣습니다.
- No Authentication / None을 선택합니다 (토큰은 URL에 이미 포함되어 있습니다).
서버 시작
```
codexpro start   # 현재 저장소에 대한 MCP 서버 실행
```
이제 서버가 ChatGPT 세션으로부터의 도구 호출을 대기합니다.

핵심 기능 (README 설명 기준)

기능	CodexPro를 통해 ChatGPT가 수행할 수 있는 작업
작업 공간 검사	`inspect_workspace`는 언어, 프로젝트 유형, 진입점, 심볼 및 내부 관계의 경량 인덱스를 구축합니다.
검색	`search`는 일반 텍스트, 정규식 및 `symbol`, `references`, `impact`와 같은 의도 기반 쿼리를 지원합니다.
편집	`write`, `edit` 또는 보호된 `apply_patch`를 통해 모델은 허용된 루트 내에서 코드 변경을 제안하고 적용할 수 있습니다.
파일 가져오기	`import_file`은 ChatGPT Apps SDK로부터 첨부 파일을 받아 저장소에 기록합니다.
명령 실행	활성화 후 안전한 하위 집합의 Bash 명령(`bash` 도구)을 실행할 수 있습니다.
차이 및 영향 분석	`show_changes`는 차이점을 반환하고, 영향을 받는 영역, 종속 코드, 관련 테스트, 위험 신호 및 제안된 검증 명령을 강조 표시합니다.
계획 및 인수인계	모델은 `.ai-bridge` 디렉토리 아래에 인수인계 계획을 작성하고 도구를 호출할 수 없는 채팅을 위해 컨텍스트 번들을 내보낼 수 있습니다.

내장 저장소 인텔리전스

**TypeScript/JavaScript, Python, Go, Rust, Swift, Java, C#, C, C++**의 선언을 인식합니다. 다른 언어는 어휘 검색 및 안전한 인벤토리 기능을 얻습니다.
외부 임베딩 서비스, 벡터 DB 또는 언어 서버 데몬이 필요하지 않습니다. 모든 것이 로컬에 캐시되고 작업 공간 지문으로 키가 지정됩니다.
결과에는 잘못된 확신 대신 커버리지 및 추론 강도 지표가 포함됩니다.

보안 기본값

명시적인 작업 공간 경계 – 노출할 디렉토리를 결정하며, 나머지는 모두 차단됩니다.
토큰 보호 터널 – 공용 HTTPS 터널에는 무작위 24바이트 토큰이 필요합니다 (~/.codexpro/http-token에 저장).
쓰기 모드는 숨겨짐 – --mode workspace로 서버를 시작하지 않는 한 비활성화됩니다.
안전한 Bash가 기본값이며, 위험한 명령은 필터링됩니다.
차단된 경로에는 .env, 개인 키, .git, 빌드 캐시 등이 포함됩니다.
첨부 파일은 ChatGPT Apps SDK를 통해 승인된 HTTPS 호스트에서만 허용됩니다.

일반적인 워크플로우

작업 공간 열기 – codexpro start (또는 codexpro start --root /path/to/repo).
ChatGPT에서 해당 저장소에 대해 open_workspace를 실행하도록 모델에 요청합니다.
모델은 다음을 수행할 수 있습니다:
- 함수 정의 검색 (search symbol MyClass.myMethod).
- 변경 제안 (edit src/foo.py), 차이 확인 (show_changes), 적용 (apply_patch).
- 테스트 명령 실행 (bash npm test).
- 수행된 작업을 요약하는 인수인계 문서 작성.
완료되면 서버를 중지하거나 다른 저장소를 위해 다른 인스턴스를 시작합니다.

확장성 및 모드

다중 프로젝트 – 단일 CodexPro 프로세스로 여러 저장소를 서비스할 수 있습니다 (codexpro settings set --project …).
도구 모드 선택 – --tool-mode minimal, full 또는 사용자 지정 카드 세트 (CODEXPRO_TOOL_CARDS=1).
헤드리스 / 인수인계 / 프로 – CI 스타일 실행, 기록 보관 또는 전체 대화형 사용을 위한 다양한 사전 설정 구성.

설치 및 업데이트

npm install -g codexpro          # 전역 설치
codexpro --version               # 확인
npm install -g codexpro@latest    # 업그레이드

구성은 `~/.codexpro` 아래에 저장되며, 바이너리를 업데이트해도 저장된 프로필은 삭제되지 않습니다.

자세히 알아보기

웹사이트 / 문서 – https://rebel0789.github.io/codexpro/
로드맵, FAQ, 보안 가이드 – 저장소에 링크됨 (ROADMAP.md, FAQ.md, SECURITY.md).
소스 – 저장소에는 기여자를 위한 CI, 스모크 테스트, 스트레스 테스트 및 릴리스 스크립트가 포함되어 있습니다.

결론

CodexPro는 독점 소스 코드를 노출하지 않고도 ChatGPT가 로컬 코드 어시스턴트로 작동할 수 있게 해주는 진정한 오픈 소스 브리지입니다. 검색 가능하고 언어 인지 능력을 갖춘 인덱싱, 안전한 편집/패치 워크플로우 및 선택적 명령 실행 기능을 제공하며, 이 모든 것은 명시적인 저장소 권한과 HTTPS 터널 인증으로 보호됩니다. LLM 기반 코딩의 편리함을 누리면서 코드와 환경을 완전히 제어하려는 개발자에게 이상적입니다.