Skip to content
Hashee Docs

Codex Plugin

Hashee Codex Plugin (@hasheeai/codex-plugin)은 OpenAI Codex를 Hashee 대화에 연결합니다. Codex 훅 시스템(stdin/stdout JSON 라우팅)을 사용하여 Agent SDK를 통해 Codex 세션과 Hashee 사용자 간에 메시지를 전달합니다.

작동 방식

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Hashee에 연결, 대화 동기화
                            ├── prompt-submit   → 사용자 프롬프트를 Hashee로 전달
                            ├── pre-tool-use    → Hashee 앱에서 권한 릴레이
                            └── stop            → 연결 해제 및 정리

플러그인은 Codex 훅 바이너리로 호출됩니다. stdin에서 JSON 이벤트를 읽고, 적절한 핸들러에 디스패치하며, stdout에 JSON 결과를 씁니다.

훅 이벤트

이벤트트리거Hashee 동작
session-startCodex 세션 시작Agent SDK 연결, 활성 대화 동기화
prompt-submit사용자 프롬프트 제출활성 Hashee 대화로 전달
pre-tool-useCodex가 도구 실행 요청Hashee 앱으로 권한 요청 릴레이
stopCodex 세션 종료Agent SDK 연결 해제, 정리

설정

1. 설치

프로젝트에 플러그인을 추가하세요:

Terminal window
npm install @hasheeai/codex-plugin

2. 환경 구성

Terminal window
export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # 선택, 이것이 기본값
변수필수기본값설명
HASHEE_AGENT_ID예—Agent UUID
HASHEE_AGENT_TOKEN예—에이전트 인증 토큰
HASHEE_SERVER_URL아니오https://api.hashee.aiAPI 기본 URL

3. Codex 훅으로 등록

Codex 훅 구성에 플러그인 바이너리를 추가하세요:

Terminal window
npx tsx packages/public/codex-plugin/src/index.ts

또는 전역 설치된 경우:

Terminal window
hashee-codex-plugin

권한 Relay

Codex가 도구 실행(예: 파일 쓰기, 쉘 명령) 권한을 요청하면 플러그인이 요청을 아티팩트로 Hashee 앱에 전달합니다. 사용자가 Hashee 대화에서 승인하거나 거부하고, 결정이 Codex로 다시 전달됩니다.

암호화

모든 암호화는 @hasheeai/agent-sdk-ts에서 처리합니다. 플러그인은 평문을 SDK로 보내고, SDK가 전송 전에 암호화합니다. 수신 메시지는 암호화된 상태로 도착하고 플러그인이 처리하기 전에 SDK가 복호화합니다.

다음 단계