Codex Oracle

codex_oracle

Codex의 작업 맥락을 GPT-6 Astra + Pro 웹 세션에 전달하고, 계획·설계·코드 검토 피드백을 다시 Codex로 가져오는 로컬 플러그인입니다.

한국어 · English · 빠른 설치 · 작동 방식 · 지원 범위 · 보안

> 개발자 프리뷰: Codex app에서 GitHub 플러그인을 직접 설치하고 검증할 수 있는 > 개발자와 초기 사용자를 대상으로 합니다.

무엇을 하나요?

• 현재 Codex 작업과 선택한 파일을 집중된 검토 프롬프트로 만듭니다.
• 외부 @Chrome 플러그인이 로그인된 사용자 Chrome에서 새 ChatGPT 대화를 엽니다.
• GPT-6 Astra의 Pro 응답을 회수해 Codex 작업의 계획·설계·리뷰 자료로 사용합니다.

작동 방식

Codex 작업 + 선택 파일
          │
          ▼
  codex_oracle 준비
          │  workspaceRoot 안에서만 파일 묶음 생성
          ▼
 @Chrome → ChatGPT Web → GPT-6 Astra + Pro
          │
          ▼
  consult_finalize → Codex 피드백

기본 라이브 경로는 consult_prepare → @Chrome → consult_checkpoint → consult_finalize입니다. 확정된 대화 URL을 저장하면 중단 후 reattach로 같은 대화에서 복구할 수 있습니다. 임시 WEB: URL은 같은 탭에서 확정 주소로 바뀔 때까지 기다리며 요청을 재전송하지 않습니다. codex_oracle은 Chrome을 내장하거나 로그인 정보를 읽지 않습니다.

필요한 것

• Codex app
• chrome@openai-bundled 플러그인
• ChatGPT에 로그인된 사용자의 Chrome 세션
• GPT-6 Astra과 Pro를 사용할 수 있는 계정
• Windows x64, macOS Apple Silicon 또는 macOS Intel

빠른 설치

Codex 에이전트에게 다음과 같이 요청하는 방법을 권장합니다.

> Burntgogi/codex_oracle의 v0.1.6 개발자 프리뷰를 설치해 주세요. 먼저 체크섬과 > 대상 경로를 확인하고 dry-run 결과를 보여 준 뒤, 내 승인을 받아 개인 marketplace에 > 설치하세요. codex_oracle@personal과 chrome@openai-bundled가 활성화됐는지 검증하고 > 새 작업에서 작은 dry-run으로 첫 호출을 점검하세요.

직접 설치할 때는 움직이는 main 대신 릴리스 태그를 사용합니다.

git clone --branch v0.1.6 --depth 1 https://github.com/Burntgogi/codex_oracle.git
cd codex_oracle
.\scripts\install-personal.ps1
# 출력 경로를 확인하고 승인한 뒤:
.\scripts\install-personal.ps1 -Apply
codex plugin add codex_oracle@personal
.\scripts\verify-installed.ps1

macOS에서는 sh scripts/install-personal.sh로 dry-run을 확인한 다음 승인 후 sh scripts/install-personal.sh --apply를 사용합니다. 전체 Windows/macOS 절차와 업데이트 방법은 [에이전트 설치 가이드](docs/AGENT_INSTALL.md)를 확인하세요.

첫 사용

Codex에서 codex_oracle을 호출하며 집중된 질문과 필요한 파일만 지정합니다.

codex_oracle로 이 구현 계획을 GPT-6 Astra + Pro에 전달해 핵심 블로커와 개선안을 검토해 줘.
먼저 dry-run으로 파일 범위를 확인하고, @Chrome을 통해 새 ChatGPT 대화에서 실행한 뒤
결과를 현재 Codex 작업으로 가져와 줘.

파일을 전달할 때는 활성 Codex 작업 영역을 workspaceRoot로 지정합니다. 큰 파일 묶음보다 구조 설명과 검토에 필요한 파일 몇 개를 선택하는 편이 안정적입니다.

지원 범위

| 환경 | 파일 | 검증 상태 | | --- | --- | --- | | Windows x64 | bin/codex_oracle.exe | 설치·MCP 스모크·Chrome live E2E 완료 | | macOS Apple Silicon | bin/codex_oracle_darwin_arm64 | cross-compile·Mach-O·dry-run 완료 | | macOS Intel | bin/codex_oracle_darwin_amd64 | cross-compile·Mach-O·dry-run 완료 |

macOS는 실제 장비에서 실행하지 않았습니다. Windows 바이너리는 서명되지 않았고 macOS 바이너리는 서명·공증되지 않았으므로 OS 또는 조직 정책의 신뢰 확인이 필요할 수 있습니다.

검증 상태

v0.1.6는 Go 테스트·정적 검사, Windows 실행, macOS 교차 빌드, 체크섬과 복구 스모크를 통과했습니다. 실제 Codex에 0.1.6을 설치하고 재시작한 뒤 웹 6 Pro 요청·응답 회수·세션 완료를 검증했습니다. 생성 중 강제 중단·복구는 동작 코드가 같은 0.1.5에서 확인했습니다. macOS 실제 실행은 미검증입니다. 자세한 근거와 한계는 [검증 기록](docs/VERIFICATION.md)을 확인하세요.

보안

기본 세션 저장은 메타데이터만 보존하며 프롬프트·답변 본문은 저장하지 않습니다. 본문 저장이 필요한 경우에만 ORACLE_SESSION_CONTENT_MODE=full을 설정하세요. 로컬 세션은 session_delete로 삭제할 수 있습니다. ChatGPT 웹 대화 기록은 별도로 남습니다.

• OPENAI_API_KEY, Chrome 쿠키 또는 로그인 자격 증명을 요구하거나 저장하지 않습니다.
• 선택 파일은 명시한 workspaceRoot 안에서만 해석하고 경로·링크가 바뀌면 닫힌 상태로 실패합니다.
• 로그인, CAPTCHA, 사람 확인, 잘못된 도메인 또는 예상 밖 민감 파일이 나타나면 중단합니다.
• 공개 이슈에 토큰, 개인 프롬프트, 비공개 저장소 내용 또는 사용자 파일을 첨부하지 마세요.

취약점 신고와 정확한 신뢰 경계는 [SECURITY.md](SECURITY.md)를 확인하세요.

이전 0.1 계열 릴리스

0.1.0-preview와 0.1.1-preview는 이전 개발자 프리뷰 기록으로 유지합니다. 새 설치에는 현재 검증된 v0.1.6 태그를 사용하세요.

감사

이 프로젝트는 steipete/oracle이 보여 준 “필요한 작업 맥락을 선별해 다른 모델에 검토받고 결과를 다시 가져오는 흐름”에서 많은 힌트를 얻었습니다. 유용한 아이디어와 공개 작업을 제공한 유지관리자와 기여자께 감사드립니다.

라이선스

[MIT License](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Burntgogi
• Source: Burntgogi/codex_oracle
• License: MIT

Install and usage instructions live in the source repository linked above.