vibememory
모든 제품 가이드

VIBE MEMORY × AGENT HARNESS

지원됨

Cursor
연결 가이드

Cursor의 Skill과 원격 MCP를 연결하고, 전용 변환 어댑터로 소문자 Hook 이벤트를 안전하게 매핑합니다.

Skill 내려받기

THREE CONNECTION LAYERS

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

01

Skill

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

02

Remote MCP

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

03

Lifecycle Hook

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

STEP 01

설치 준비

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

Cursor 전용 어댑터를 검토된 절대 경로에 복사하세요. Codex나 Muse의 Hook 파일을 그대로 사용하면 안 됩니다.

STEP 02

Skill과 CLI 연결

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

# Install the Vibe Memory Skill from the ZIP or the install prompt
# Review agent-adapters/cursor before enabling hooks
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 "Cursor"

STEP 03

원격 MCP 연결

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

{
  "mcpServers": {
    "vibe-memory": {
      "url": "https://vibememory.io/mcp"
    }
  }
}

STEP 04

자동 Hook 설치

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

어댑터agent-adapters/cursor/vibe_memory_hook.py설정 위치
~/.cursor/hooks.json.cursor/hooks.json
sessionStartadditional_context
stopone bounded followup_message
preCompactpending marker

STEP 05

검증

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

Customize → Hooks
Hooks output channel
Customize → MCPs

업데이트와 제거

업데이트

# Replace the adapter, then re-merge the three reviewed entries

제거

# Remove the three Vibe Memory hook entries and copied adapter

제약과 보안 경계

Stop의 loop_limit은 1로 유지하고 failClosed는 false로 둡니다. Windows에서는 python3 대신 py를 사용합니다.

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