vibememory
모든 제품 가이드

VIBE MEMORY × AGENT HARNESS

지원됨

OpenAI Codex
연결 가이드

Codex CLI와 Desktop에는 Skill, 원격 MCP, 검토 가능한 로컬 Hook을 각각 연결합니다.

Skill 내려받기

THREE CONNECTION LAYERS

각 연결은 역할이 다릅니다.

01

Skill

언제 기억을 찾고 무엇을 저장할지 에이전트에 알려주는 작업 지침입니다.

02

Remote MCP

OAuth 웹 승인으로 기억, 문서 메타정보, 관계와 메시지 도구를 제공합니다.

03

Lifecycle Hook

세션 시작, 종료와 압축 시점에 CLI를 호출하는 로컬 자동화입니다.

STEP 01

설치 준비

현재 제품과 버전을 먼저 확인하고, 이 페이지의 설정만 적용하세요. 기존 설정 파일을 통째로 교체하지 말고 Vibe Memory 항목의 diff를 검토합니다.

CLI 또는 Desktop의 로컬 Codex 런타임에서 진행하세요. IDE 확장에서는 Skill과 직접 MCP 연결을 사용하고 플러그인 설치를 전제로 하지 않습니다.

STEP 02

Skill과 CLI 연결

콘솔의 설치 프롬프트 또는 Skill ZIP으로 최신 지침을 설치합니다. CLI 인증은 브라우저 승인 링크로 진행하며 API 키를 채팅에 붙여넣지 않습니다.

# Copy the Vibe Memory Skill into your Codex skill directory
# Then open it once so Codex reads the current SKILL.md
VM_SKILL_DIR="/absolute/path/to/installed/vibe-memory"
MEMORY_URL=https://vibememory.io python3 "$VM_SKILL_DIR/scripts/memory.py" sync
"$VM_SKILL_DIR/bin/vibe-memory" login --url https://vibememory.io --no-browser --name "OpenAI Codex"

STEP 03

원격 MCP 연결

원격 MCP는 Skill이나 Hook과 독립적으로 사용할 수 있습니다. 연결 시 Vibe Memory 로그인과 권한 승인 화면에서 요청된 범위를 직접 확인합니다.

codex mcp add vibe-memory --url https://vibememory.io/mcp
codex mcp list

STEP 04

자동 Hook 설치

Hook은 로컬에서 프로젝트명과 Git 상태 지문만 CLI에 전달합니다. 대화 원문, 모델 응답, 파일 내용, 환경변수와 Vault 값은 전달하지 않습니다.

어댑터agent-adapters/codex/hooks.json설정 위치
~/.codex/hooks.json.codex/hooks.json
SessionStartrecall
Stopcheckpoint reminder
PreCompactpending marker

STEP 05

검증

설치 완료 메시지만 믿지 말고 제품 자체의 목록, 진단 또는 설정 화면에서 실제 로드를 확인합니다.

/hooks
codex mcp list
vibe-memory --version

업데이트와 제거

업데이트

# Re-copy the reviewed Vibe Memory hook groups
/hooks

제거

# Remove only the Vibe Memory groups from hooks.json
codex mcp remove vibe-memory

제약과 보안 경계

Command Hook은 로컬 실행 환경이 필요합니다. Work Cloud나 로컬 실행 권한이 없는 표면에서는 Skill과 MCP만 사용합니다.

Vibe Memory 서버는 저장, 조회, 권한과 결정론적 데이터 관리를 담당합니다. 파일 분석, 키워드 추출, 엔티티·관계 추론과 실제 외부 작업은 이 에이전트가 수행합니다.